Skip to content

feat: add short URL and multi-page video support #175

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
1Lucas1apk merged 3 commits into from
Feb 14, 2026
Merged

feat: add short URL and multi-page video support #175

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
b874558
add: Hoshimi client
1Lucas1apk Feb 7, 2026
867be53
update: Lavalink-Client entries
1Lucas1apk Feb 10, 2026
a47c1a1
feat: add short URL and multi-page video support
ParrotXray Feb 14, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
216 changes: 3 additions & 213 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -86,217 +86,6 @@ docker run -p 2333:2333 nodelink

---

### Diagram

```mermaid
flowchart TD
%% =========================
%% NODELINK / LAVALINK STACK
%% Detailed, GitHub-compatible
%% =========================

subgraph L1["Layer 1: Client Access"]
direction LR
Bot["Discord Bot\nCommands/Events"]
Lib["Lavalink Client\nWS + REST"]
API["API Gateway\nHTTP + WS termination"]
RecvClient["Voice Receive Client\n(Recorder)"]
PCMClient["Direct PCM Client\n(HTTP PCM)"]

Bot -- "control + intents" --> Lib
Lib -- "REST: /loadtracks /sessions /players" --> API
Lib -- "WS: opcodes (play/pause/seek/filters)" --> API
RecvClient -- "WS voice receive" --> API
PCMClient -- "HTTP POST PCM" --> API
end

subgraph L2["Layer 2: Master Orchestrator"]
direction TB

API_In["REST Handlers\nValidation + streaming limits"]
WS_GW["WebSocket Gateway\nClient Control"]
VoiceWS["Voice Receive WS Router\nIngest frames/events"]

SessionMgr["Session Manager\nPlayer/session lifecycle"]

subgraph Managers["Resource & Control Managers"]
direction LR
WorkerMgr["Worker Manager\nVoice workers"]
SourceMgr["Source Worker Manager\nSearch/Resolve/Decrypt"]
StatsMgr["Stats Manager\nPrometheus/Metrics"]
PluginMgr["Plugin Manager\nHooks/Providers"]
end

API --> API_In
API --> WS_GW
API --> VoiceWS

API_In --> SessionMgr
WS_GW --> SessionMgr
VoiceWS --> SessionMgr

SessionMgr --> WorkerMgr
SessionMgr --> SourceMgr
SessionMgr -. "metrics/logs" .-> StatsMgr
SessionMgr -. "plugin hooks" .-> PluginMgr

API_In -. "task delegation" .-> Managers
end

subgraph BUS["Binary Socket Bus"]
direction LR
VCmd["Command Pipe\nv8 serialization"]
VEvt["Event Pipe\nbinary stream"]
SMeta["Metadata Pipe\ncustom framing"]
end

subgraph L3["Layer 3: Execution Plane"]
direction TB

subgraph SrcCluster["Source Worker Cluster"]
direction TB
SW_IPC["IPC Task In\nprocess.send()"]
SW_Q["Priority Task Queue\nresolve/search/decrypt"]

subgraph SWPool["Micro-Worker Thread Pool"]
direction LR
T1["Thread 1"]
T2["Thread 2"]
TN["Thread 32"]
end

SW_Net["Source Network Interface\nHTTP(S) fetch / CDN"]
SW_Sock["Socket Client\nmetadata out"]

SW_IPC --> SW_Q
SW_Q -- "dispatch" --> SWPool
SWPool -- "network I/O" --> SW_Net
SW_Net -- "metadata + timing + headers" --> SW_Sock
end

subgraph VoiceCluster["Voice Worker Cluster"]
direction TB

VW_Sock["Socket Listener\ncommands in"]
InternalMgr["Internal Source Manager\nper-player stream control"]

subgraph DSP["DSP Pipeline"]
direction TB
PipeIn["StreamProcessor\npull stream"]
Demux["Demux / Decode"]
Resample["Resampler\n48 kHz"]
Ring["RingBuffer"]
MixLayers["Mix Layers"]
Mixer["AudioMixer"]
BPool["BufferPool"]
Filters["Filters / Volume"]
Encoder["Opus Encoder\n20ms frames"]

PipeIn --> Demux --> Resample --> Ring
MixLayers -.-> Ring
Ring --> Mixer
BPool -.-> Mixer
Mixer --> Filters --> Encoder
end

subgraph DAVE["DAVE Security Engine"]
direction LR
UDPIn["UDP Socket In\nDiscord voice recv"]
DDec["DAVE AEAD Decryptor"]
VRelay["Voice Receive Bus\nframes/events"]
DEnc["DAVE AEAD Encryptor"]

UDPIn --> DDec --> VRelay
end

VW_Sock --> InternalMgr
InternalMgr -- "stream url / seek / stop" --> PipeIn
Encoder --> DEnc
end
end

subgraph L4["Layer 4: Output Plane"]
direction LR
Discord["Discord Voice Gateway"]
end

subgraph SUP["Infrastructure & Support Services"]
direction LR
Route["RoutePlanner\nIP rotation/bind"]
Creds["CredentialManager\nAES-256-GCM storage"]
Log["Logger / Audit"]
Err["ErrorHandler\nsendErrorResponse"]
end

%% Inter-layer connections
Lib -- "WS control" --> WS_GW
Lib -- "REST control" --> API_In

RecvClient -- "WS voice frames/events" --> VoiceWS
VRelay -- "voice frames/events" --> VoiceWS

PCMClient -- "HTTP PCM stream" --> API_In

SourceMgr -- "IPC tasks: resolve/search/decrypt" --> SW_IPC

SW_Sock -- "metadata packet" --> SMeta
SMeta -- "track metadata, duration, headers, hints" --> SourceMgr

WorkerMgr -- "net.write(command)" --> VCmd
VCmd -- "command" --> VW_Sock

VRelay -- "internal feedback (health/seq/rtp)" --> VEvt
VEvt -- "events" --> WorkerMgr

DEnc == "Encrypted Opus (AEAD)" ==> Discord

API_In -. "warn/error" .-> Log
WS_GW -. "warn/error" .-> Log
VoiceWS -. "warn/error" .-> Log

API_In -. "413/400/etc" .-> Err
WS_GW -. "close codes" .-> Err

Creds -. "inject credentials" .-> Managers
Creds -. "inject keys (DAVE/ARL/etc)" .-> SrcCluster
Creds -. "inject voice keys/session" .-> VoiceCluster

Route -. "bind outbound ip" .-> SW_Net
Route -. "bind outbound ip" .-> PipeIn

PluginMgr -. "source hooks" .-> SourceMgr
PluginMgr -. "voice hooks" .-> WorkerMgr
PluginMgr -. "rest/ws hooks" .-> API_In

StatsMgr -. "record metrics" .-> Managers
StatsMgr -. "record metrics" .-> SrcCluster
StatsMgr -. "record metrics" .-> VoiceCluster

%% Layout anchors
L1 ~~~ L2
L2 ~~~ BUS
BUS ~~~ L3
L3 ~~~ L4
L4 ~~~ SUP

%% Styling (GitHub supports classDef/class)
classDef layer fill:#0f172a,stroke:#334155,color:#cbd5e1
classDef component fill:#1e293b,stroke:#475569,color:#f1f5f9
classDef focus fill:#1e1b4b,stroke:#818cf8,color:#e0e7ff
classDef critical fill:#064e3b,stroke:#34d399,color:#ecfdf5
classDef infra fill:#312e81,stroke:#6366f1,color:#e0e7ff,stroke-dasharray: 5 5
classDef manager fill:#1e3a8a,stroke:#3b82f6,color:#ffffff

class L1,L2,L3,L4,SUP layer
class Bot,API,API_In,WS_GW,VoiceWS,StatsMgr,PluginMgr,SW_Q,SW_Net,UDPIn,VRelay,Log,Err,T1,T2,TN,RecvClient,PCMClient,Demux,Resample,Ring,MixLayers,Filters component
class Lib,SW_IPC,SW_Sock,VW_Sock,PipeIn,Encoder,Mixer focus
class DDec,DEnc,Discord critical
class BUS,VCmd,VEvt,SMeta,Route,Creds,BPool infra
class SessionMgr,WorkerMgr,SourceMgr manager
```

---

## Usage

NodeLink is compatible with most Lavalink clients, as it implements nearly the entire original API.
Expand All @@ -313,11 +102,12 @@ However, some clients may not work properly, since NodeLink changes certain beha
| [Pomice](https://github.com/cloudwithax/pomice) | Python | unknown | No | v1 and v2 | |
| [lava-lyra](https://github.com/ParrotXray/lava-lyra) | Python | Yes | Yes | v3 | |
| [Hikari-ongaku](https://github.com/MPlatypus/hikari-ongaku) | Python | unknown | No | v1 and v2 | |
| [Moonlink.js](https://github.com/1Lucas1apk/moonlink.js) | TypeScript | Yes | No | v1, v2, v3 | |
| [Moonlink.js](https://github.com/1Lucas1apk/moonlink.js) | TypeScript | Yes | Yes | v1, v2, v3 | |
| [Magmastream](https://github.com/Blackfort-Hosting/magmastream) | TypeScript | unknown | No | v1 | |
| [Lavacord](https://github.com/lavacord/Lavacord) | TypeScript | unknown | No | v1 and v2 | |
| [Shoukaku](https://github.com/Deivu/Shoukaku) | TypeScript | Yes | No | v1, v2, v3 | |
| [Lavalink-Client](https://github.com/tomato6966/Lavalink-Client) | TypeScript | No | No | v1 | Unstable for some users who have reported this over the months; maintainer does not commit to feature support; users must implement missing behavior externally; recommended to migrate to a more stable client |
| [Hoshimi](https://github.com/Ganyu-Studios/Hoshimi) | TypeScript | Yes | No | v1, v2, v3 | ;P |
| [Lavalink-Client](https://github.com/tomato6966/Lavalink-Client) | TypeScript | Yes | Yes | v1, v3 | |
| [Rainlink](https://github.com/RainyXeon/Rainlink) | TypeScript | unknown | No | v1 and v2 | |
| [Poru](https://github.com/parasop/Poru) | TypeScript | unknown | No | v1 and v2 | |
| [Blue.ts](https://github.com/ftrapture/blue.ts) | TypeScript | unknown | No | v1 and v2 | |
Expand Down
Loading