We're excited to announce the first release of Ethos - a modern CLI music player that brings your music experience to the terminal!
🌟 Key Features
-
Online Music Playback
- Search and stream music directly from YouTube
- High-quality audio playback
- Queue management system
- Volume control and basic playback functions
-
Modern Terminal UI
- Rich text interface with dynamic layouts
- Real-time playback progress
- Music metadata display
- Command-based interaction
-
Keyboard Controls
Ctrl+C/Q
- Quit applicationCtrl+M
- Pause playbackCtrl+R
- Resume playbackCtrl+1/2
- Volume controls
🔧 Installation
# Using pipx (recommended)
pipx install ethos-cli
# Or using pip
pip install ethos-cli
📝 Requirements
- Python 3.9+
- VLC media player
- Internet connection for streaming
🛠️ Basic Commands
/play <track> # Search and play a track
/pause # Pause playback
/resume # Resume playback
/volume <0-100> # Set volume
/queue-add <track> # Add to queue
/show-queue # View current queue
/help # Show all commands
For more info about Ethos visit the official docs.
🔍 Future Plans
- Local music library support coming in future releases
- Spotify playlist integration in development
📋 Notes
This is our initial release focusing on online playback functionality. Local library support and additional features are planned for future releases.
🙏 Acknowledgements
Thanks to all contributors who helped make this release possible.