Walros-Dev/ConceptDocs
6
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

add initial goals documentation #1

Merged
patrik merged 8 commits from goals into main 2025-12-01 13:48:39 +01:00
Conversation 14 Commits 8 Files changed 1 +105
patrik commented 2025-10-14 21:12:44 +02:00
Owner
Copy link

#2

#2
Signed-off-by: Patrik Fodor <fodor.patrik.2000@gmail.com>
marcsello reviewed 2025-10-14 21:18:10 +02:00
goals.md Outdated
@ -0,0 +4,4 @@
- **Caching & Performance:**
- Use cached segments for seamless seeking and fast resume.
- If another user starts playback with the same parameters, reuse existing cached data to minimize transcoding and bandwidth usage.
- Includes CDN capabilities and P2P federation by Blint.
marcsello commented 2025-10-14 21:18:10 +02:00
Owner
Copy link

I think CDN deserves it's own section here. I personally have a few ideas for it.

I think CDN deserves it's own section here. I personally have a few ideas for it.
👍 1
marcsello marked this conversation as resolved
marcsello reviewed 2025-10-14 21:18:54 +02:00
goals.md Outdated
@ -0,0 +16,4 @@
- Native Clients: Desktop (Windows, Linux, MacOS), Mobile (Android, iOS), TV (Android TV, Apple TV, WebOS, Roku, Someone could create one for Xbox)
- Multiuser Support in clients: You are able to login with multiple users and change between them.
- **Offline Access:**
- Clients can batch-download content for offline playback, respecting user permissions and device limits.
marcsello commented 2025-10-14 21:18:54 +02:00
Owner
Copy link

What are device limits exactly?

What are device limits exactly?
patrik commented 2025-10-14 21:28:19 +02:00
Author
Owner
Copy link

Just too much copying and pasting. It should not be there.

Just too much copying and pasting. It should not be there.
patrik commented 2025-10-14 22:11:37 +02:00
Author
Owner
Copy link

Removed

Removed
marcsello marked this conversation as resolved
marcsello reviewed 2025-10-14 21:20:08 +02:00
goals.md Outdated
@ -0,0 +45,4 @@
- **Multi-Format Detection:** Detect multiple versions (e.g., 1080p, 4K, HDR) of the same media and show them in a unified view.
- **IPTV / Live TV:** Stream and manage live channels alongside on-demand content.
## Architecture
marcsello commented 2025-10-14 21:20:08 +02:00
Owner
Copy link

I would add "Resiliency" as in. "Temporary outage in one service should not affect/disrupt the viewing experience" or something similar along the lines

I would add "Resiliency" as in. "Temporary outage in one service should not affect/disrupt the viewing experience" or something similar along the lines
👍 1
patrik commented 2025-10-14 22:11:22 +02:00
Author
Owner
Copy link

Added

Added
marcsello marked this conversation as resolved 
Signed-off-by: Patrik Fodor <fodor.patrik.2000@gmail.com>
Added a detailed specification for CDN functionality, including:
- Lightweight CDN node concept (simple executable for users)
- Secure connectivity using pre-shared keys
- Dynamic registration with main metadata server and DNS assignment
- Content awareness, replication, and streaming fallback
- Peer-to-peer (P2P) sharing for distributed content transfer
- Federation and collaboration between CDNs
- Future idea: predictive caching based on user activity

This formalizes the CDN architecture for Walros, supporting distributed caching,
federation, and smarter prefetching mechanisms."
blint commented 2025-10-16 09:17:11 +02:00
Owner
Copy link

added CDN functionality, @patrik @marcsello please take a look 👀

added CDN functionality, @patrik @marcsello please take a look 👀
patrik reviewed 2025-10-16 09:43:01 +02:00
goals.md Outdated
@ -0,0 +36,4 @@
- Multiple CDNs can share content and metadata within a trusted federation network.
- The system can automatically balance or replicate popular content across CDNs to optimize bandwidth usage and ensure availability.
- **Future Idea - Predictive Caching:**
patrik commented 2025-10-16 09:43:01 +02:00
Author
Owner
Copy link

This part should be moved to the later section @blint .

This part should be moved to the later section @blint .
patrik marked this conversation as resolved 
- Change "series" to "TV show" to make it clearer
- Move CDN future goal to the Later section

Signed-off-by: Patrik Fodor <fodor.patrik.2000@gmail.com>
Signed-off-by: Patrik Fodor <fodor.patrik.2000@gmail.com>
patrik removed this from the Walros Development project 2025-10-16 10:05:08 +02:00
marcsello reviewed 2025-10-17 11:20:51 +02:00
goals.md
@ -0,0 +30,4 @@
- **Peer-to-Peer (P2P) Sharing:**
- CDNs and the main server interconnect via **P2P protocols** to simplify file transfer and reduce reliance on centralized infrastructure.
- This enables faster, bandwidth-efficient distribution of popular content between geographically distributed CDNs.
marcsello commented 2025-10-17 11:20:51 +02:00
Owner
Copy link

This is not a goal, this is an explanation.

This is not a goal, this is an explanation.
blint marked this conversation as resolved
marcsello reviewed 2025-10-17 11:22:14 +02:00
goals.md Outdated
@ -0,0 +14,4 @@
- **Secure Connectivity:**
- Each CDN connects to the **main metadata server** using a **pre-shared key** for authentication and trust establishment.
- This ensures only authorized CDNs can register and exchange data with the main network.
marcsello commented 2025-10-17 11:22:14 +02:00
Owner
Copy link

This isn't a goal, that's an explanation.

This isn't a goal, that's an explanation.
blint marked this conversation as resolved
marcsello reviewed 2025-10-17 11:25:16 +02:00
goals.md Outdated
@ -0,0 +33,4 @@
- This enables faster, bandwidth-efficient distribution of popular content between geographically distributed CDNs.
- **Federation & Collaboration:**
- Multiple CDNs can share content and metadata within a trusted federation network.
marcsello commented 2025-10-17 11:25:16 +02:00
Owner
Copy link

What does a "trusted federation network" mean in this context?

What does a "trusted federation network" mean in this context?
blint commented 2025-10-21 15:37:48 +02:00
Owner
Copy link

a connection between the instances via VPN

a connection between the instances via VPN
marcsello commented 2025-10-23 22:47:41 +02:00
Owner
Copy link

I think we should write that instead. To me it's more exact and therefore easier to understand.

I think we should write that instead. To me it's more exact and therefore easier to understand.
blint marked this conversation as resolved
marcsello reviewed 2025-10-17 12:04:56 +02:00
goals.md Outdated
@ -0,0 +28,4 @@
1. **Request content replication:** Copy or prefetch the content from another CDN or the main server.
2. **Stream fallback:** Stream the content directly from the main server or the nearest available CDN.
- **Peer-to-Peer (P2P) Sharing:**
marcsello commented 2025-10-17 12:04:56 +02:00
Owner
Copy link

I think this would be better in the "Nice to have/later" part. Sounds a bit complex to be a core feature. (especially if you want to pack all this up to a single binary)

I think this would be better in the "Nice to have/later" part. Sounds a bit complex to be a core feature. (especially if you want to pack all this up to a single binary)
blint marked this conversation as resolved
marcsello reviewed 2025-10-17 12:10:12 +02:00
goals.md
@ -0,0 +4,4 @@
- **Caching & Performance:**
- Use cached segments for seamless seeking and fast resume.
- If another user starts playback with the same parameters, reuse existing cached data to minimize transcoding and bandwidth usage.
- **CDN Capabilities and P2P Federation**
marcsello commented 2025-10-17 12:10:12 +02:00
Owner
Copy link

I think it might worth including that what content does exactly a CDN node deliver? For starters I think serving only "media" would be good.

I think it might worth including that what content does exactly a CDN node deliver? For starters I think serving only "media" would be good.
blint marked this conversation as resolved
blint approved these changes 2025-11-27 16:18:11 +01:00
blint left a comment
Copy link

/lgtm

/lgtm
marcsello approved these changes 2025-11-29 12:01:25 +01:00
blint commented 2025-11-30 11:00:45 +01:00
Owner
Copy link

@patrik wanna take a look?

@patrik wanna take a look?
patrik commented 2025-12-01 12:31:33 +01:00
Author
Owner
Copy link

Lgtm
I can't approve my own PR @blint

Lgtm I can't approve my own PR @blint
patrik merged commit 985c2112af into main 2025-12-01 13:48:39 +01:00
patrik deleted branch goals 2025-12-01 13:48:55 +01:00
Sign in to join this conversation.
Reviewers
No reviewers
blint
marcsello
Labels
Clear labels
  
bug
Something is not working

  
duplicate
This issue or pull request already exists

  
enhancement
New feature

  
help wanted
Need some help

  
invalid
Something is wrong

  
question
More information is needed

  
wontfix
This won't be fixed

No labels
bug
duplicate
enhancement
help wanted
invalid
question
wontfix
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
3 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
Walros-Dev/ConceptDocs!1
No description provided.