Skip to content

git installation instruction

AliReza AmirSamimi edited this page Jul 19, 2025 · 54 revisions

If you are using ArchLinux base os or ubuntu base os or fedora base os or OpenSuse base os , we recommend to use persepolis repository. You can find installation instructions in our website , because git version is on development and not stable . but if you want install persepolis from git for any reason follow this instructions .

Linux

Before running install file make sure that all dependencies are installed on your system!

You must have python3-pysocks , python3-urllib3 , python 3 , pyqt5 or pyside6 , qt5-svg or qt6-svg , python3-requests , python3-setproctitle , meson , python3-psutil , ffmpeg , yt-dlp, ‍‍‍‍‍python3-dasbus‍ installed. In some disributions you must install python3-pyqt5.qtsvg. If you use PyQt5 you must install qt5-qtmultimedia too.

Persepolis can use Pyside6 or PyQt5. Pyside6 is newer. If Pyside6 is in your distro. repositories you can install pyside6 and qt6-svg. You can also install all python packages from pip.

OPTIONAL DEPENDENCIES

yt-dlp and ffmpeg are used for downloading video from youtube and ... . How to use Persepolis video finder? checkout this link please. ffmpeg is used for playing notifications and It's just an optional dependency. python3-dasbus is used for showing desktop notification messages and It is an optional dependency.

Installing the breeze package makes the application look better on GTK+ and Qt desktops. Note that this package has different names in different distributions.

Conclusion

All four dependency packages are optional and it is not a problem if they are not installed. But we strongly recommend installing them.


Installing Dependencies for Archlinux

     sudo pacman -S python-pysocks python-urllib3 pyside6 qt6-svg python-requests python-setproctitle meson python-psutil yt-dlp ffmpeg python-dasbus breeze

Installing Dependencies for Debian and Debian base distros (ubuntu, ... )

Debian testing(trixie) and newer - Ubuntu 24.10 and newer

sudo apt-get install python3-socks python3-urllib3 python3-requests python3-setproctitle meson ninja-build python3-psutil yt-dlp ffmpeg python3-dasbus kde-style-breeze python3-pyside6.qtcore python3-pyside6.qtgui python3-pyside6.qtwidgets python3-pyside6.qtmultimedia python3-pyside6.qtsvg python3-pyside6.qtsvgwidgets

Older version of Debian and ubuntu

     sudo apt-get install python3-socks python3-urllib3 python3-pyqt5 libqt5svg5 qt5-qtmultimedia python3-requests python3-setproctitle meson ninja-build python3-psutil yt-dlp ffmpeg python3-pyqt5.qtsvg python3-dasbus

Installing Dependencies for Fedora

     sudo dnf install python3-pysocks python3-urllib3 python3-pyside6 qt6-qtsvg python3-requests python3-setproctitle meson ninja-build python3-psutil yt-dlp ffmpeg python3-dasbus plasma-breeze

another optinal dependencies:

If you use GTK+ desktop environments(Gnome, Cinammon, Mate, XFCE, Budgie, ...), we recommend you to install adwaita-qt package.This package help you to get a uniform look between persepolis and the other applications in your desktop environments.

In ArchLinux:

  yay -S adwaita-qt6

In Debian,Ubuntu, Mint ,...(This package may not be available in old distributions) :

  sudo apt-get install adwaita-qt

In Fedora:

  sudo dnf install adwaita-qt6

Installing Persepolis Download Manager itself

     git clone "https://github.com/persepolisdm/persepolis.git" 
     cd persepolis

to install

     meson setup builddir
     cd builddir
     meson compile
     sudo meson install

If you want to package persepolis for a distribution and you are not familiar with meson, Please checkout this link. you can also checkout our AUR package. Please feel free to open an issue for more help :) .

to uninstall, use uninstall.py script in persepolis repo.

    sudo python3 ./uninstall.py

If you installed Persepolis 3.X or 2.X before and you want to install version 4.x, Please run uninstall.py script first.

FreeBSD

Read this

Windows

Read this

Mac

Read this

Clone this wiki locally