Installation, Start, Upgrade und Deinstallation

Repository klonen

git clone https://codeberg.org/CarstenHa/mp3FastCut

Installation mit install.sh

Für Debian/Ubuntu gibt es ein kleines Skript, was einem die Installation erleichtert:
install.sh
Es werden außschließlich Symlinks im User-Verzeichnis angelegt.
Außerdem wird eine eine virtuelle Umgebung (Python) erzeugt und die Programme numpy pydub matplotlib pillow pygame scipy mutagen und ffmpeg-normalize in der VE installiert.
install.sh setzt eine funktionsfähige Python3-Installation und das Modul python3-venv zur Erzeugung einer virtuellen Umgebung voraus.

Weitere Informationen erhalten Sie mit:

install.sh -h

Manuelle Installation für Debian/Ubuntu

Empfohlen wird die Installation im lokalen HOME-Verzeichnis.

  1. Virtuelle Umgebung anlegen:

    cd /path/to/mp3FastCut
python3 -m venv "${PWD}"
source bin/activate
bin/pip3 install numpy pydub matplotlib pillow pygame scipy mutagen ffmpeg-normalize
bin/pip3 freeze >requirements.txt
deactivate
  2. In der Datei mp3fastcut.desktop.bsp muss in der Zeile Exec= der auszuführende Befehl eingetragen werden:
    Exec=/path/to/VE/bin/python3 /path/to/VE/mp3fastcut.py
  3. Die Datei mp3fastcut.desktop.bsp muss umbenannt werden in mp3fastcut.desktop und in ein passendes Verzeichnis verschoben werden. Bei Debian/Ubuntu ist das zum Beispiel das Verzeichnis:
    ~/.local/share/applications
  4. Abschließend muss noch das Programmicon:
    icons/hicolor/48x48/apps/mp3fastcut.png
    in ein passendes Verzeichnis kopiert werden. Bei Debian/Ubuntu ist das zum Beispiel das Verzeichnis:
    ~/.local/share/icons

Start

Danach ist mp3FastCut über das Menü Ton & Video verfügbar:

_images/mp3fastcut.png

Start im Terminal

Hat man mp3FastCut mit install.sh installiert, kann man das Programm über die Kommandozeile aufrufen mit:

mp3fastcut

Ansonsten mit dem Befehl:

/path/to/VE/bin/python3 /path/to/VE/mp3fastcut.py

Upgrade mit install.sh

Für Debian/Ubuntu kann man für das Upgrade folgenden Befehl nutzen:

install.sh -u
Damit wird das Repository, alle nötigen Python-Pakete sowie eine mögliche Offline-Dokumentation im Ordner pages aktualisert.
Siehe dazu: Kann man die Dokumentation offline verfügbar machen?

Manuelles Upgrade für Debian/Ubuntu

  1. Aktualisierung des Repositorys:

cd /path/to/mp3FastCut

# Repository
git fetch origin
git merge origin/master

# Mögliche Offline-Dokumentation
[ -d ./pages ] && git subtree pull --prefix=pages . origin/pages

  1. Aktualisierung der installierten Programme in der virtuellen Umgebung:

source bin/activate && \
bin/pip3 install -U numpy pydub matplotlib pillow pygame scipy mutagen ffmpeg-normalize
bin/pip3 freeze >requirements.txt
deactivate

Deinstallation

Für die Deinstallation kann man unter Debian/Ubuntu install.sh -U ausführen.
Damit werden die gesetzten Symlinks entfernt.
Anschließend muss man dann nur noch das komplette Repository löschen, um mp3FastCut komplett von seinem System zu entfernen.