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 aria2 , libnotify-bin , python 3 , pyqt5 or pyside6 , qt5-svg or qt6-svg , python3-requests , python3-setproctitle , meson , python3-psutil , ffmpeg, sound-theme-freedesktop , gost or sthp, 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

1- yt-dlp and ffmpeg are used for downloading video from youtube and ... . How to use Persepolis video finder? checkout this link please.

2- gost or sthp for socks5 support.

Installing Dependencies for Archlinux

     sudo pacman -S aria2 gost 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, ... )

     sudo apt-get install aria2 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 aria2 sound-theme-freedesktop libnotify python3-pyside6 qt6-qtsvg python3-requests python3-setproctitle meson ninja-build python3-psutil yt-dlp ffmpeg

Installing sthp or gost for socks5 support

gost is available in ArchLinux repositories but It's not available in fedora or debian ... repositories. If you want "socks5" support, you must install gost or sthp. Please execute this commands line by line in terminal for installing sthp.

cd /tmp
aria2c -o 'sthp' 'https://github.com/KaranGauswami/socks-to-http-proxy/releases/download/v0.4.0/sthp-linux'
chmod +x ./sthp
sudo cp '/sthp' '/usr/local/bin/'

test sthp with this command:

sthp -V

You can install gost with snapcraft.

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