[[Vorlage(Getestet, bionic)]]

{{{#!vorlage Wissen
[:Pakete_installieren: Installation von Programmen]
[:Programme_starten:]
}}}
[[Inhaltsverzeichnis(1)]]

[[Bild(./projectm_logo.png, 48, align=left)]]
[sourceforge2:projectm:projectM] {en} ist eine Audiovisualisierung, die entweder durch bestimmte Audioplayer direkt unterstützt wird ([:Audacious:], [:Clementine:] und [:qmmp:Qmmp]) oder allgemein mit den Soundservern [:PulseAudio:] und [:JACK:] verwendet werden kann. Dabei handelt es sich um eine Weiterentwicklung von [wikipedia_en:MilkDrop:], das wiederum auf den Visualisierungseffekten des Audioplayers [wikipedia:Winamp:] beruht.

Dieser Artikel beschäftigt sich mit der Integration in PulseAudio (PA), das bei fast allen Ubuntu-Varianten zum Einsatz kommt.
= Installation =
Folgende Pakete müssen installiert werden [1]:

{{{#!vorlage Paketinstallation
libvisual-projectm, universe
projectm-pulseaudio, universe
}}}

= Verwendung =
Bei Ubuntu-Varianten mit einem Anwendungsmenü findet man einen Programmstarter unter ''"Multimedia -> projectM PulseAudio Visualization"'' [2]. Ansonsten verwendet man den Befehl `projectM-pulseaudio` (mit großem `M`).

Die Steuerung erfolgt über Tastenkürzel. Eine Übersicht der wichtigsten Tasten:

[[Bild(./projectm.png, 250, align=right)]]

{{{#!vorlage Tabelle
<-2 tableclass="zebra_start3" rowclass="titel"> Tastenkürzel
+++
<rowclass="kopf" >Taste(n)
Funktion
+++
[[Vorlage(Tasten, f)]]
Vollbildmodus
+++
[[Vorlage(Tasten, m)]]
Menü ([#Einstellungen Einstellungen])
+++
[[Vorlage(Tasten, n)]]
Nächster Effekt
+++
[[Vorlage(Tasten, p)]]
Vorheriger Effekt
+++
[[Vorlage(Tasten, l)]]
Effektwechsel deaktivieren
+++
[[Vorlage(Tasten, r)]]
Zufälliger Effekt
+++
[[Vorlage(Tasten, F1)]]
Kurzhilfe
+++
[[Vorlage(Tasten, F3)]]
Name des Effekts
+++
[[Vorlage(Tasten, F4)]]
Rendering-Informationen
+++
[[Vorlage(Tasten, F5)]]
FPS-Anzeige
}}}

== Einstellungen ==
[[Bild(./projectm_menu.png, 150, align=right)]]
Die Einstellungen von projectM sind über die Menü-Taste [[Vorlage(Tasten, m)]] zugänglich. Neben einer Liste der enthaltenen Effekte können bei Bedarf bestimmte Einstellungen wie beispielsweise die vom Programm verwendeten Pfade angepasst werden.

Gespeichert werden diese Einstellungen in der Datei '''~/.projectM/config.inp''' im [:Homeverzeichnis:].

== Presets ==
In einem "Preset" sind alle Anweisungen zusammengefasst, die eine Visualisierung ausmachen. Dabei handelt es sich um Textdateien mit der Endung '''.milk'''. Neben den mitgelieferten Presets im Ordner '''/usr/share/projectM/presets''' lassen sich zahlreiche weitere im Internet finden. Allerdings funktionieren manche nicht mit projectM.

Presets lassen sich über das Kontextmenü [[Vorlage(Tasten, rmb)]] auch anpassen. Geänderte Presets sollten im [:Homeverzeichnis:] gespeichert werden, idealerweise in einem eigenen Ordner.

= Problembehebung =
== Asynchrone Visualisierung ==
Es kann vorkommen, dass der Takt des Musikstücks und die Visualisierung nicht synchron ablaufen. Zum einen kann der Rechner schlicht zu langsam sein, um Audiowiedergabe und aufwendige grafische Effekte gleichzeitig verarbeiten zu können. Zum anderen enthält nicht jedes Preset eine saubere "beat detection" (Erkennung des Takts).
== projectM startet nicht ==
Manchmal startet projectM nach einer Neuinstallation nicht.
Wenn man projectM über die Konsole ausführt:
{{{#!vorlage Befehl
projectM-pulseaudio
}}}
Und dabei folgende Meldung erscheint:
{{{
Could not open font file: /usr/share/fonts/truetype/ttf-dejavu/DejaVuSans.ttf
}}}
Dann müssen die folgenden beiden Pakete für die Schriftart '''DejaVuSans''' neu installiert werden:
{{{#!vorlage Paketinstallation
fonts-dejavu, universe
fonts-dejavu-core
}}}
Anschließend müssen mit den folgenden Befehlen noch passende Verknüpfungen erstellt werden:
{{{#!vorlage Befehl
sudo mkdir -p /usr/share/fonts/truetype/ttf-dejavu
sudo ln -s /usr/share/fonts/truetype/dejavu/DejaVuSans.ttf /usr/share/fonts/truetype/ttf-dejavu/DejaVuSans.ttf
sudo ln -s /usr/share/fonts/truetype/dejavu/DejaVuSansMono.ttf /usr/share/fonts/truetype/ttf-dejavu/DejaVuSansMono.ttf
}}}

= Links =
 * [sourceforge2:projectm:Projektseite] {en}
 * [archwiki:projectM:] {en} - Archwiki
 * [ubuntu_fr:projectm:] {fr} im franz. Ubuntu-Wiki
 * [https://web.archive.org/web/20030324120541/http://www.milkdrop.co.uk/Downloads/Authoring%20Guide.doc Beginners guide to MilkDrop preset writing] {en} - 04/2002
 * [:Multimedia:] {Übersicht} Übersichtsseite

#tag: Multimedia, Audioplayer, Audio, Qt