[[Vorlage(Getestet, focal)]]

{{{#!vorlage Wissen
[:Pakete_installieren: Installation von Programmen]
[:Terminal: Ein Terminal öffnen]
[:Programme_starten: Starten von Programmen]
}}}

[[Inhaltsverzeichnis()]]

[[Bild(Wiki/Icons/terminal.png, 48, align=left)]]
[github:hrkfdn/ncspot:ncspot] {en} ist ein von [https://affekt.org/ hrkfdn] {en} geschriebener, leichtgewichtiger [:Terminal:]-Client für [wikipedia:Spotify:]. Er ist eine Alternative zum offiziellen [:Spotify:Spotify Client]. Das Programm ist in [wikipedia:Rust_(Programmiersprache):Rust] geschrieben und nutzt die freie Programmbibliothek [wikipedia:ncurses:]. Es steht unter der [https://opensource.org/licenses/BSD-2-Clause BSD 2-Clause License] {en}. Voraussetzung der Nutzung von ncspot ist ein Premiumaccount von Spotify.

= Installation =

ncspot ist nicht in den Ubuntu-Quellen enthalten. Es muss manuell kompiliert werden. ncspot ist von folgenden Programmen abhängig, die installiert sein müssen [1]:

{{{#!vorlage Paketinstallation
rustc, universe
libpulse-dev
libssl-dev
libxcb1-dev
libxcb-render0-dev
libxcb-shape0-dev
libxcb-xfixes0-dev
libasound2-dev
libncurses-dev
libssl-dev
libdbus-1-dev
pkg-config
}}}

Nach der Installation der Abhängigkeiten muss ncspot heruntergeladen werden. Dies geschieht am besten durch das Klonen des Git-Verzeichnisses des Programms. Dazu muss [:Git:] installiert sein. Das Git-Verzeichnis kann dann mit folgendem Befehl geklont werden:

{{{#!vorlage Befehl
git clone https://github.com/hrkfdn/ncspot
}}}

Nach dem Wechsel in das neu heruntergeladene Verzeichnis kann ncspot mit folgendem Befehl kompiliert werden, was einige Zeit dauern kann:

{{{#!vorlage Befehl
cargo build --release
}}}

[[Vorlage(Fremd, Software)]]

= Bedienung =
Wenn ncspot im [:Homeverzeichnis:] heruntergeladen und kompiliert wurde, wird es standardmäßig im folgenden Ordner installiert: '''~/ncspot/target/release/'''. Es kann dann im Terminal [2] mit folgendem Befehl aufgerufen werden [3]:

{{{#!vorlage Befehl
~/ncspot/target/release/ncspot
}}}

{{{#!vorlage Hinweis
Die entsprechende Datei kann als [:Umgebungsvariable:] verwendet werden, um den Programmstart mit dem Befehl `ncspot`, also ohne Angabe des ganzen Pfades, zu ermöglichen. Alternativ kann mit einem [:alias:] ein Kurzbefehl erstellt werden, der es erlaubt, das Programm zu starten. Der folgende Alias erlaubt es, ncspot mit Hilfe des Befehls `spot` zu starten: `alias spot='~/ncspot/target/release/ncspot'`
}}}

Nach dem ersten Start des Programms fragt ncspot die persönlichen Spotify-Login-Informationen ab. Die Daten werden gespeichert und müssen bei einem erneuten Programmstart nicht wieder eingegeben werden.

{{{#!vorlage Hinweis
Startet man cmus in einem aufklappbaren Terminal-Emulator wie [:Yakuake:] oder [:Tilda:], kann das Programm anschließend einfach per Knopfdruck ein- und ausgeblendet werden.
}}}

== Ansichten ==
[[Vorlage(Bildunterschrift, ncspot2.png, 450, "ncspot in der Bibliotheksansicht (hier: Albumsansicht)", right)]]

Mit Hilfe der folgend genannten Funktionstasten kann zwischen verschiedenen Programmansichten gewechselt werden:

{{{#!vorlage Tabelle
<rowclass="titel"-2> Ansichten von `ncspot`
+++
<rowclass="kopf"> Taste
Beschreibung
+++
[[Vorlage(Tasten, F1)]]
Wiedergabeliste
+++
[[Vorlage(Tasten, F2)]]
Suche
+++
[[Vorlage(Tasten, F3)]]
Bibliothek
+++
[[Vorlage(Tasten, backspace)]]
Schließt die gegenwärtige Ansicht
+++
}}}

== Tastaturbefehle ==
Das Programm kann unter anderem mit folgenden Tastaturbefehlen bedient werden:

{{{#!vorlage Tabelle
<rowclass="titel"-2> Tastaturbefehle von `ncspot`
+++
<rowclass="kopf"> Taste
Beschreibung
+++
[[Vorlage(Tasten, return)]]
Spielt den ausgewählten Track oder die ausgewählte Playlist ab
+++
[[Vorlage(Tasten, shift+p)]]
Pause/Wiedergabe des gegenwärtig abgespielten Tracks
+++
[[Vorlage(Tasten, .)]]
Spring in der Wiedergabelistenansicht zum aktuell gespielten Track 
+++
[[Vorlage(Tasten, >)]]
Nächster Track
+++
[[Vorlage(Tasten, <)]]
Vorheriger Track
+++
[[Vorlage(Tasten, shift+s)]]
Stop der Wiedergabe

+++
[[Vorlage(Tasten, space)]]
Verschiebt den ausgewählten Track in die Wiedergabeliste
+++
[[Vorlage(Tasten, c)]]
Löscht in der Wiedergabelistenansicht die komplette Wiedergabeliste
+++
[[Vorlage(Tasten, d)]]
Löscht in der Wiedergabelistenansicht den augenblicklich gewählten Track sowie in der Bibliotheksansicht die augenblicklich gewählte Playlist oder den augenblicklich ausgewählten Track
+++
[[Vorlage(Tasten, s)]]
Speichert den gegenwärtig gespielten Track in der Bibliothek
+++
[[Vorlage(Tasten, r)]]
Wiederholungsmodus
+++
[[Vorlage(Tasten, z)]]
Zufallswiedergabemodus
+++
[[Vorlage(Tasten, o)]]
Öffnet ein Kontextmenü für das gegenwärtig ausgewählte Element
+++
[[Vorlage(Tasten, q)]]
Beendet das Programm
}}}

Die Navigation innerhalb der Ansichten sowie auch zwischen diesen kann mit Hilfe der Pfeiltasten erfolgen. Weitere Befehle sind der [github:hrkfdn/ncspot:Projektseite] {en} zu entnehmen.

= Erscheinungsbild =

Mit Hilfe der Konfigurationsdatei von ncspot, '''~/.config/ncspot/config.toml''', kann auch das Erscheinungsbild des Programms verändert werden. Auf der Projektseite ist beispielsweise die folgende Möglichkeit angegeben, das Erscheinungsbild des Programs dem des offiziellen Client anzupassen. Die entsprechenden Farben können beliebig verändert werden.


{{{[theme]
background = "black"
primary = "light white"
secondary = "light black"
title = "green"
playing = "green"
playing_bg = "black"
highlight = "light white"
highlight_bg = "#484848"
error = "light white"
error_bg = "red"
statusbar = "black"
statusbar_progress = "green"
statusbar_bg = "green"
cmdline = "light white"
cmdline_bg = "black"}}}

= Links =
== extern ==
 * [github:hrkfdn/ncspot:ncspot] {en} – Projektseite
== intern ==
 * [:Shell/Anwendungen:]
 * [:Spotify:]

#tag: Shell, Multimedia, Audioplayer