How to Install Persepolis on Ubuntu 22.04 LTS – The Download Manager That Doesn’t Suck
Ever tried downloading a big file only to have it stall and then magically disappear? I’ve seen this happen after a bad driver update or when the network hiccups mid‑transfer. Persepolis fixes that by giving you a queue, resume, and scheduling right out of the box. This guide shows you how to get it running on Ubuntu 22.04 LTS in just a few clicks.
Prerequisites: Keep Your System Fresh
Before adding anything new, make sure your base system is up‑to‑date. A stale kernel or missing libraries can bite later when Persepolis tries to launch.
sudo apt update && sudo apt upgrade -y
This step also pulls in python3-pip, which we’ll use if you opt for the pip route.
Install from the Official PPA (Easiest Path)
Persepolis ships in a maintained PPA that keeps it on the latest stable release. Adding the PPA tells Ubuntu where to find the package and handles future updates automatically.
sudo add-apt-repository ppa:persepolis/ppa -y sudo apt update sudo apt install persepolis -y
The PPA guarantees that you’re not downloading an outdated binary that might miss critical bug fixes. It also keeps the package in sync with your system’s dependency chain, reducing the chance of broken links or missing modules.
Alternative: Install via pip (If You Like Control)
If you prefer a pure‑Python install or need the very latest bleeding‑edge commit, skip the PPA and use pip. This installs Persepolis into your user environment without touching system packages.
python3 -m pip install --user persepolis
After this, add ~/.local/bin to your $PATH if it isn’t already:
echo 'export PATH=$PATH:~/.local/bin' >> ~/.profile source ~/.profile
The pip route gives you a sandboxed copy that won’t interfere with other Python applications. It’s handy if you’re juggling multiple Python projects or want to test new features without polluting the system.
Verify the Installation
Launch Persepolis from your application menu, or run:
persepolis
You should see a clean GUI pop up with a download queue on the left and a status bar at the bottom. If it crashes immediately, double‑check that all dependencies are installed; sometimes missing libqt5widgets5 can cause a silent exit.
Quick Test: Download a Large File
Try pulling a 1 GB test file from a reliable source (e.g., a Linux distro ISO). Add the URL to Persepolis, hit “Start,” and watch it build the queue. If the network drops mid‑download, simply pause and resume – no data loss.
Real‑world observation: I once watched a friend waste an entire afternoon on a broken torrent download that never finished. After switching to Persepolis, he resumed from where it left off in seconds, saving hours of frustration. That’s the kind of reliability you get when a tool is built around resuming and retrying.
Final Tweaks
- Set a Max Concurrent Downloads: In Preferences => Download, choose how many files Persepolis should handle simultaneously. Too high, and your bandwidth gets split thin; too low, and you waste idle slots.
- Enable “Resume” by default: Under the same tab, tick “Always resume if possible.” It’s a lifesaver when Wi‑Fi drops unexpectedly.
- Add to Startup (Optional): If you like having the manager ready whenever you boot, add it to Startup Applications so Persepolis pops up automatically.
That’s all there is to it. Install once, enjoy faster, more reliable downloads, and never waste time staring at a stalled progress bar again.