Installation - theRealCarneiro/pulsemeeter GitHub Wiki

Table of Contents

Installing Dependencies

Dependencies

  • pip
  • libappindicator3
  • gobject-introspection-1.0
  • libpulse

Python dependencies

Pip will automatically install these dependencies for you

Optional dependencies

noise-suppression-for-voice has to be installed manually in most systems, there's a great tutorial on how to do it in the wiki page

pulse-vumeter tutorial on README

Arch/Manjaro

All dependencies are pulled when downloading from the AUR

Ubuntu/Linux Mint (apt based)

noise-suppression-for-voice and pulse-vumeter must be built from source

sudo apt update
sudo apt install python3-pip swh-plugins libgirepository1.0-dev libpulse-dev libappindicator3-dev

In some newer distributions you may have to install this package (#66):

sudo apt install gir1.2-appindicator3-0.1

Fedora

pulse-vumeter must be built from source

sudo dnf update
sudo dnf copr enable -y lkiesow/noise-suppression-for-voice
sudo dnf install -y ladspa-realtime-noise-suppression-plugin python3-pip ladspa-swh-plugins gobject-introspection-devel libappindicator-gtk3

If you're using pulseaudio (pipewire users don't need to install this) you need to install pulseaudio-utils:

sudo dnf install pulseaudio-utils

Installation

Arch/Manjaro

Two packages are available in the AUR pulsemeeter-git and pulsemeeter.

Any distro

Build zipapp from source (recommended for non technical users)

A very straightforward way to install pulsemeeter is using the makefile, it builds a zip build of the application with most python dependencies already bundled:

git clone https://github.com/theRealCarneiro/pulsemeeter.git
cd pulsemeeter
sudo make install

To uninstall just run this on the source directory:

sudo make uninstall

Build from source (venv)

git clone https://github.com/theRealCarneiro/pulsemeeter.git
cd pulsemeeter
python -m venv .venv
source .venv/bin/activate
pip install .

Build from source (pipx)

git clone https://github.com/theRealCarneiro/pulsemeeter.git
cd pulsemeeter
python -m venv .venv
source .venv/bin/activate
pipx install .

Build from source using --break-system-packages (NOT RECOMENDED)

Since pep 668, pip now doesn't allow users to manage their system packages, passing that responsibility to the Distro package manager. To go around that you have to pass --break-system-packages to pip (WARNING: like the name suggests, doing this might break your system):

git clone https://github.com/theRealCarneiro/pulsemeeter.git
cd pulsemeeter
sudo pip install . --break-system-packages

Pypi

A package is available for it in pypi

sudo pip install pulsemeeter

Or use pipx for automatically managing the venv:

pipx install pulsemeeter

Build from nightly source

- Warning: These are development versions and may include bugs!

git clone https://github.com/theRealCarneiro/pulsemeeter.git
cd pulsemeeter
git checkout nightly
pip install .

Nightly installation/update script

- Warning: These are development versions and may include bugs!

You can use this script to easily maintain the nightly version. Fl1tzi/pulsemeeter-nightly-script.

You should not execute any file coming from curl blind without checking if it is coming from a genuine source and without knowing what the script does (downloading before executing would be the best)! Check out the source with this command:

curl -s https://raw.githubusercontent.com/Fl1tzi/pulsemeeter-nightly-script/main/script.sh | less

Install/Update:

bash -c '. <(curl -s https://raw.githubusercontent.com/Fl1tzi/pulsemeeter-nightly-script/main/script.sh)'

Installing/Updating without sudo

bash -c '. <(curl -s https://raw.githubusercontent.com/Fl1tzi/pulsemeeter-nightly-script/main/script.sh) no-sudo'

Delete cache:

bash -c '. <(curl -s https://raw.githubusercontent.com/Fl1tzi/pulsemeeter-nightly-script/main/script.sh) delete-cache'

Uninstall

sudo pip uninstall pulsemeeter