Quick Start
Do you want the interface? Two ways to install, each with its own steps. If you are not sure, take the first: the interface can be added later.
Terminal and button
A keyboard shortcut, the piperread command or the Read Selection button in your menu reads the selection. One package.
1. Install the package for your distribution
# Debian, Ubuntu, Mint
sudo apt install ./piperread_0.4.1~beta_all.deb
# Fedora
sudo dnf install ./piperread-0.4.1~beta-1.fc44.noarch.rpm
# openSUSE Leap
sudo zypper install ./piperread-0.4.1~beta-1.leap160.noarch.rpm
# Arch Linux
sudo pacman -U ./piperread-0.4.1beta-1-any.pkg.tar.zst
Download PiperRead →2. Add a voice (nothing downloads before you confirm)
piperread --download-voice
3. Select a text, then click Read Selection in your menu, or run
piperread
With the interface
The same, plus a tray icon that starts with your session, keeps the voice loaded, and adds pause, resume and sentence-by-sentence navigation. One archive holds both packages.
1. Extract the all-in-one archive and install both packages (Debian shown)
# Debian, Ubuntu, Mint
tar -xzf piperread-all-in-one-0.4.1-beta-debian.tar.gz
sudo apt install ./piperread_0.4.1~beta_all.deb ./piperread-gui_0.4.1~beta_all.deb
Download PiperRead →2. Start the interface: with no voice, a window offers to download one
piperread-gui --play
3. Select or copy a text, then click the tray icon.
On Windows, only the interface exists: unzip the folder, double-click piperread-gui.exe, and download a voice from the window that opens. The two sequences above are for Linux: Download PiperRead →
Prefer to install from a clone of the repository? The steps are in the README →
