How benexl/yt-x works
Main Components
a) Core Application Layer:
• Terminal UI Interface (using fzf/rofi)
• Command Processing Module
• Configuration Manager
• Extension System
b) External Services Layer:
• YouTube API Integration (via yt-dlp)
• Local File System Interface
• Media Player Integration (mpv/vlc)
c) Data Management Layer:
• Custom Playlists Storage
• History & Recent Tracks
• Saved Channels/Videos
• Configuration Files
┌─────────────────────────────────────────┐
• User Interface │
• (Terminal/fzf/rofi/gum interfaces) │
• ┤
• Core Application │
• ┌──────────┐ ┌──────────┐ ┌──────┐ │
• Command │ │Extension │ │Config│ │
• Processor │ │Manager │ │Manager│ │
• ┘ └──────────┘ └──────┘ │
• ┤
• External Integrations │
• ┌──────────┐ ┌──────────┐ ┌──────┐ │
• yt-dlp │ │ mpv │ │ curl │ │
• Interface │ │Interface │ │ API │ │
• ┘ └──────────┘ └──────┘ │
• ┤
• Data Storage │
• (Playlists, History, Config) │
• ┘
Important Flows to Highlight
a) User Interaction Flow:
• How user commands flow from UI through the command processor
• How results are displayed back to the user
b) Media Playback Flow:
• Demonstrate the path from video selection to playback
• Integration with mpv/vlc
c) Extension System Flow:
• How extensions integrate with the core system
• Extension loading and execution paths
Implementation Details
• File system structure for configurations (~/.config/yt-x/)
• External dependency connections
• Data flow between components
• Error handling paths