git installation instruction

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-urllib3 , libnotify-bin , python 3 , pyqt5 or pyside6 , qt5-svg or qt6-svg , python3-requests , python3-setproctitle , meson , python3-psutil , ffmpeg, sound-theme-freedesktop , yt-dlp installed. In some disributions you must install python3-pyqt5.qtsvg.

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 pyside and yt-dlp 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.

Installing Dependencies for Archlinux

     sudo pacman -S python-urllib3 libnotify pyside6 qt6-svg python-requests python-setproctitle meson sound-theme-freedesktop python-psutil yt-dlp ffmpeg

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

If you are a Debian sid user, you can install package libpyside6-py3-6.6 instead of package python3-pyqt5.

     sudo apt-get install python3-urllib3 sound-theme-freedesktop libnotify-bin python3-pyqt5 libqt5svg5 python3-requests python3-setproctitle meson ninja-build python3-psutil yt-dlp ffmpeg python3-pyqt5.qtsvg

Installing Dependencies for Fedora

     sudo dnf install python3-urllib3 sound-theme-freedesktop libnotify python3-pyside6 qt6-qtsvg python3-requests python3-setproctitle meson ninja-build python3-psutil yt-dlp ffmpeg

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 qadwaitadecorations-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-qt

---

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,

    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.

Windows

Read this

Mac

Read this