|a6797423cb||1 day ago|
|img||1 week ago|
|scripts||1 day ago|
|.gitignore||1 month ago|
|CHANGELOG.md||7 days ago|
|README.md||1 day ago|
|org.codeberg.ralfhersel.youplay.metainfo.xml||3 months ago|
|org.codeberg.ralfhersel.youplay.yml||3 months ago|
|requirements.txt||1 month ago|
|requirements_qt.txt||1 week ago|
|youplay.desktop||1 month ago|
|youplay.desktop.flatpak||1 month ago|
|youplay.desktop.python||1 month ago|
|youplay.py||1 week ago|
|youplay.sh||2 years ago|
|youplay.svg||2 years ago|
|youplay_qt.py||1 week ago|
|youplay_v0.38_GTK3_x86_64.AppImage||1 day ago|
|youplay_v0.44_GTK4_x86_64.AppImage||1 day ago|
|youplay_v0.45_GTK4_x86_64.AppImage||1 day ago|
|youplay_v0.45_Qt6_x86_64.AppImage||1 day ago|
Welcome to YouPlay
Do you love music, but hate restrictions?
With YouPlay you can search for whatever music in your mind. It will list a number of matching songs from YouTube. You can listen to it and YouPlay will download it as an mp3 file.
YouPlay in GUI-mode
YouPlay in CLI-mode
You can install the Python-Script, generate a Flatpak or try the AppImage:
I recommend to install YouPlay manually as described in the next chapter.
A Flatpak package is ready, but not distributed to Flathub.org because I don't want to feed Microsofts GitHub, which is required for Flathub.org publications. All files for the Flatpak are available in this repository, but you need to know how to build a Flatpak.
J.r maintains an AUR package
Prof. P. created AppImages for various versions: check the AppImage files
This installation method is still the preferred one, because it is easy and has the smallest installation size. Run these commands in a terminal:
git clone https://codeberg.org/ralfhersel/youplay.git cd youplay
Than install these packages with the package manager of your GNU/Linux distribution:
On Debian-based systems you can do this with one command:
sudo apt install mpv libmpv1 ffmpeg python3-pip
On Arch-based systems:
sudo pacman -S mpv ffmpeg python-pip
On Fedora-based systems:
sudo dnf install mpv mpv-libs ffmpeg pip3
Now install the necessary Python libraries with:
pip install -r requirements.txt
youplay.shexecutable in your file manager
- Change the paths (Exec and Icon) in
youplay.desktopto your paths (e.g.: /home/yourpath/youplay). Please replace the Exec and Icon settings with absolute paths to your YouPlay directory. Example:
Exec=/home/ralf/dev/youplay/youplay.sh -g Icon=/home/ralf/dev/youplay/youplay.svg
GNOME and KDE-Plasma: SUPER + youplay
Terminal: navigate to
/home/user/[your_script_folder]/youplay/Run it with:
./youplay.shIf you get GUI or TUI depends on the settings in
Thanks to Prof.P, there is an AppImage available. This image works on several desktop environments (Plasma, GNOME, LXQt, Cinnamon, MATE) if Gtk4 and Libadwaita are available. Here are commands to install them:
sudo pacman -S gtk4 libadwaita
sudo dnf install gtk4 libadwaita
You can download the AppImage file, make it executable and run it. If you need a better integration in the GNOME-Desktop, take a look at AppImageLauncher. Install it before you launch the AppImage with AppImageLauncher.
There is also an older AppImage available which is based on Gtk3, in case your distribution does not support Gtk4 and Libadwaita. The features are almost the same.
The Qt-port version uses the Python-bindings for the Qt GUI-Toolkit.
Install the necessary Python libraries with:
pip install -r requirements_qt.txt
youplay_qt.pyexecutable in your file manager
Run it with:
YouPlay supports two modes: CLI (command line mode) and GUI (graphical mode).
You can start YouPlay in CLI mode like this:
Navigate in a terminal to your YouPlay directory:
All other options will be shown interactively.
You can also start YouPlay in GUI mode:
- Navigate in a terminal to your YouPlay directory:
- or from your application menu or launcher (this requires
youplay.desktopwith adapted paths, copied to
When the GUI shows up, you can enter a song title (min 4 characters) that you want to listen to. The App will present a list of 10 matching songs from Youtube. Select one or doubleclick to start downloading and playing it. All songs that you are listened to, are stored as mp3 files in a subfolder named 'youplay' under your standard music folder in home. A song, that was already downloaded, will not be downloaded again, as long as the file exists in the 'youplay' subfolder. You can show and play all downloaded songs with the SONG button. Just enter another search term to return to the search list.
Since Youtube changes the API every now and then, it is recommended to update
Author: Ralf Hersel