๐ฆ Installation
๐ฎ Music management
๐ง Playlist management
๐ฆ๏ธ Controls
โ๏ธ Configuration
๐พ Cache
๐ Update
๐ License
๐ข Acknowledgments
wget https://github.com/Malwarize/retro/releases/download/v0.0.40/installer.tar.gz
tar -xvf installer.tar.gz
chmod +x installer.sh
./installer.sh
this installer is for linux of systemd
based systems, if you are using other systems you can install it manually by compiling the source code then run the server as you like.
~/.local/bin/uninstall_retro.sh
retro play "Despacito - Luis Fonsi" # you can search and play music by name
play command is smart enough to play music from different sources, you can play music by name, url, file path, directory path, queue, and playlist.
retro play "https://www.youtube.com/watch?v=kJQP7kiw5Fk" # you can play music by url
retro play queue_music # you can play music from queue, you can do this with music index in the queue
retro play ~/Music/Despacito.mp3 # you can play music by file path
retro play ~/Music/ # you can play music by directory path, it will play all music in the directory
retro play queue_music # it prioritize music in queue and play it first you can do this with music index in the queue
retro play playlist_name # you can play music from playlist
retro status # ๐ต check the queue status tasks downloading|searching, playing|paused, songs in queue
retro pause # โธ๏ธ
retro resume # โถ ๏ธ
retro next # โญ๏ธ๏ธ
retro prev # โฎ๏ธ๏ธ
retro remove music_name #๐๏ธ
you can remove music from queue by name or index retro remove 1
retro vol 50 # ๐๏ธ set volume to 50%
retro vol 0 # ๐ mute volume Adjust
retro stop # ๐
retro list create my_playlist # ๐
retro list add my_playlist "Despacito - Luis Fonsi" # โ search and add song to playlist
retro list add my_playlist "https://www.youtube.com/watch?v=kJQP7kiw5Fk" # โ add song to playlist by url
retro list add my_playlist queue_music # โ add music from queue
you can add music to playlist by name, url, queue (index|nameretro list add my_playlist music_index
) and file path
retro list remove my_playlist "Despacito - Luis Fonsi" # โ remove song from playlist
retro list remove my_playlist 1 # โ remove song from playlist by index
retro list my_playlist # ๐ show all songs in playlist
retro list play my_playlist # ๐ add all songs in playlist to queue
retro list remove my_playlist # ๐ delete playlist
retro logs # ๐ show all logs #last 200 lines
retro logs info # ๐ข show all info logs
retro logs error # ๐ซ show all error logs
retro logs warn # โ ๏ธ show all warning logs
retro theme pink #๐งผ
retro theme purple #๐ฎ
retro theme blue #๐
# TODO: retro theme custom
retro help #โ show all commands
retro help play #โ show play command help
retro cache # ๐พ show all cached data
retro cache clear # ๐งน clear all cache
the config file is located by default in ~/.retro/config.json
if not found, you can create it manually by
mkdir -p ~/.retro
touch ~/.retro/config.json
{
"retro_path": "~/.retro/",
"path_ytldpl": "yt-dlp",
"path_ffmpeg": "ffmpeg",
"path_ffprobe": "ffprobe",
"search_timeout": 60000000000,
"theme": "pink",
"db_path": "~/.retro/retro.db",
"discord_rpc": false,
"log_file": "~/.retro/retro.log",
"server_port": "3131"
}
you can change the config manually, easy to understand and modify.
- โ ๏ธ if you change the config file, its recommended to restart the retro service.
with
systemctl --user restart retro
โ ๏ธ the config file will override the default values.- ๐ค please make sure to setup the autocompletion script to have a better experience with retro. see
retro completion
to update retro to the latest version on github you can use the following command
retro update
This project is licensed under the MIT License - see the LICENSE file for details