Skip to content

FreeBSD Support

AliReza AmirSamimi edited this page Jul 14, 2025 · 14 revisions

Unfortunately, we don't have an official package for BSD, but if anyone is interested in maintaining Persepolis for BSD distributions, we would welcome it. Persepolis has been tested on GhostBSD and works fine.

Installing Persepolis on FreeBSD and GhostBSD

Install dependencies

To install Persepolis you need to install this Python3 packages:
requests , pysocks, urllib3, setproctitle, psutil, yt-dlp , PySide6
You can easily find them in freebsd repository with package search command. As you know, the names of these packages change based on the version of Python in the FreeBSD repositories. Always install the latest version.
At the time of writing, the names of these packages are as follows:
py311-requests, py311-pysocks, py311-urllib3, py311-setproctitle, py311-psutil, py311-yt-dlp, py311-pyside6

In the next step, you need to install ffmpeg. To make Persepolis more compatible with your desktop, it is highly recommended that you also install the plasma6-breeze package. If you use GTK+ base desktop environments(Gnome, XFCE, Mate, ...) and you like adwaita theme, You can install adwaita-qt6 package. You must install git and meson for cloning and installing Persepolis

Conclusion

Install this packages on your system:

sudo pkg install py311-requests py311-pysocks py311-urllib3 py311-setproctitle py311-psutil py311-yt-dlp py311-pyside6 ffmpeg plasma6-breeze git

Then clone and install Persepolis:

     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
Clone this wiki locally