Installation, Start, Upgrade und Deinstallation
===============================================

.. index:: single: Repository klonen

Repository klonen
-----------------

.. code-block:: bash

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

.. index:: single: Installation mit install.sh

Installation mit install.sh
---------------------------

| Für Debian/Ubuntu gibt es ein kleines Skript, was einem die Installation erleichtert:

.. code-block:: bash

   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:

.. code-block:: bash

   install.sh -h

.. index:: single: Manuelle Installation für Debian/Ubuntu

Manuelle Installation für Debian/Ubuntu
---------------------------------------

Empfohlen wird die Installation im lokalen ``HOME``-Verzeichnis.

1. Virtuelle Umgebung anlegen:

   .. code-block:: bash

      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``

.. index:: single: Start von mp3FastCut

Start
-----

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

.. index:: single: Upgrade mit install.sh

.. image:: _static/apps/mp3fastcut.png

**Start im Terminal**

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

.. code-block:: bash

   mp3fastcut

Ansonsten mit dem Befehl:

.. code-block:: bash

   /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:

.. code-block:: bash

   install.sh -u

| Damit wird das Repository, alle nötigen Python-Pakete sowie eine mögliche Offline-Dokumentation im Ordner ``pages`` aktualisert.
| Siehe dazu: :ref:`Kann man die Dokumentation offline verfügbar machen? <faq-offline>`

.. index:: single: Manuelles Upgrade für Debian/Ubuntu

Manuelles Upgrade für Debian/Ubuntu
-----------------------------------

1. Aktualisierung des Repositorys:

.. code-block:: bash

   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

2. Aktualisierung der installierten Programme in der virtuellen Umgebung:

.. code-block:: bash

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

.. index:: single: Deinstallation

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.