lowfi/docs/fr/README.md

lowfi

lowfi est une petite application écrite en Rust qui sert un objectif unique : écouter de la lofi. Elle le fait de la manière la plus simple possible : pas d’albums, pas de pubs, juste de la lofi.

Attention

À partir de la version 1.7.0 de lowfi, tous les fichiers audio intégrés par défaut proviennent de chillhop. Consultez MUSIQUE pour plus d’informations.

Pourquoi ?

Je déteste les plateformes de musique modernes, et je voulais une application, petite et simple, qui mettrait simplement de la lofi aléatoire, sans vidéo ni autres fioritures.

Au-delà de ça, elle a aussi été conçue pour être assez résistante aux connections instables, et cache 5 morceaux entiers à la fois.

Installation

Note

Si vous êtes intéressé par la maintenance d’un paquet pour lowfi sur des gestionnaires de paquets comme Homebrew ou autres, ouvrez une issue.

Dépendances

Sur toutes les plateformes : Rust 1.83.0+.

Sur macOS et Windows, aucune dépendance supplémentaire n’est nécessaire.

Sur Linux, vous aurez aussi besoin d’openssl et d’alsa.

• alsa-lib sur Arch, libasound2-dev sur Ubuntu, alsa-lib-devel sur Fedora.
• openssl sur Arch, libssl-dev sur Ubuntu, openssl-devel sur Fedora.

Si vous utilisez PulseAudio vous aurez aussi besoin d’installer pulseaudio-alsa.

Cargo

La méthode d’installation recommandée est cargo :

cargo install lowfi

# Si vous voulez utiliser le protocole MPRIS.
cargo install lowfi --features mpris

Assurez-vous que $HOME/.cargo/bin est ajouté à votre $PATH. Voir également Fonctionnalités supplémentaires pour des fonctionnalités étendues.

Packets précompilés

Si vous rencontrez des difficultés ou ne souhaitez pas utiliser cargo, vous pouvez simplement télécharger les exécutables précompilés depuis la dernière release.

AUR

yay -S lowfi

openSUSE

zypper install lowfi

Debian

Note

Ce packet est sur un dépôt non officiel maintenu par Dario Griffo.

curl -sS https://debian.griffo.io/3B9335DF576D3D58059C6AA50B56A1A69762E9FF.asc | gpg --dearmor --yes -o /etc/apt/trusted.gpg.d/debian.griffo.io.gpg
echo "deb https://debian.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/debian.griffo.io.list
sudo apt install -y lowfi

Fedora (COPR)

Note

Ce packet utilise un dépôt COPR non officiel par FurqanHun.

sudo dnf copr enable furqanhun/lowfi
sudo dnf install lowfi

Manuel

Utile pour le débogage.

git clone https://github.com/talwat/lowfi
cd lowfi

# Si vous voulez un exécutable
cargo build --release --all-features
./target/release/lowfi

# Si vous voulez juste tester
cargo run --all-features

Utilisation

lowfi

Oui, c’est tout.

Contrôles

Touche	Fonction
s, n, l	Passer le morceau
p, Espace	Lecture / Pause
+, =, k, ↑	Volume +10 %
→	Volume +1 %
-, _, j, ↓	Volume -10 %
←	Volume -1 %
q, CTRL+C	Quitter
b	Ajouter aux Favoris

Note

En plus de ces contrôles habituels, lowfi est compatible avec les touches multimédia de votre machine ainsi qu'avec le standard MPRIS (avec des outils comme playerctl).

MPRIS est actuellement une fonctionnalité optionnelle dans Cargo (activée avec --features mpris) car elle est uniquement destinée à Linux, et parce que le but principal de lowfi est son interface unique et minimaliste.

Favoris

Les favoris sont la réponse extrêmement simple de lowfi à la question « et si je voulais garder un morceau ? ». Vous pouvez ajouter ou retirer des morceaux des favoris avec b, et les lire avec lowfi -t bookmarks.

D’un point de vue technique, vos favoris ne sont pas différents de n’importe quelle autre liste de morceaux, et sont donc stockés dans le même répertoire.

Options supplémentaires

Si vous avez quelque chose que vous souhaitez ajuster dans lowfi, vous pouvez utiliser des options supplémentaires qui modifient légèrement l’interface ou le comportement du menu. Les options peuvent être consultées avec lowfi --help.

Option	Fonction
-a, --alternate	Utiliser un écran de terminal alternatif
-m, --minimalist	Masquer la barre de contrôle inférieure
-b, --borderless	Exclure les bordures de l’interface
-p, --paused	Lancer lowfi en pause,
-f, --fps	FPS de l’interface [défaut : 12]
--timeout	Délai d’attente en secondes pour les téléchargements
-d, --debug	Inclure les logs ALSA et autres
-w, --width <WIDTH>	Largeur du lecteur, de 0 à 32 [défaut : 3]
-t, --track-list <TRACK_LIST>	Utiliser une liste de pistes personnalisée
-s, --buffer-size <BUFFER_SIZE>	Nombre de morceaux ajoutés au cache en avance [défaut : 5]

Fonctionnalités supplémentaires

lowfi utilise le système de « features » de cargo/rust pour rendre certaines parties du programme optionnelles, notamment celles qui ne sont censées être utilisées que par une minorité d’utilisateurs.

scrape - Scraping

Cette fonctionnalité fournit la commande scrape. Elle n’est généralement pas très utile, mais est incluse par souci de transparence.

Plus d’informations sont disponibles en exécutant lowfi help scrape.

mpris - MPRIS

Active MPRIS.

extra-audio-formats - Formats audio supplémentaires

Ceci est uniquement pertinent pour les utilisateurs de listes de pistes personnalisées ; dans ce cas, cela permet plus de formats que le simple MP3, à savoir FLAC, Vorbis et WAV.

Ces formats devraient couvrir environ 99 % des fichiers audio que les gens souhaitent lire. Si vous faites partie du 1 % utilisant un autre format audio, et présent dans cette liste, ouvrez une issue.

Listes de pistes personnalisées

Note

Certains gentils utilisateurs, en particulier danielwerg, ont déjà créé des listes alternatives situées dans le dossier data de ce dépôt. Vous pouvez les utiliser avec lowfi en utilisant l’option --track-list.

N’hésitez pas à proposer votre propre liste via une pull request.

lowfi prend également en charge les listes de pistes personnalisées, bien que celle par défaut de chillhop soit intégrée directement dans l'exécutable.

Pour utiliser une liste personnalisée, utilisez l’option --track-list. Cela peut être soit un chemin vers un fichier, soit le nom d’un fichier (sans l’extension .txt) présent dans le dossier données.

Note

Répertoires de données par plateforme :

• Linux - ~/.local/share/lowfi
• macOS - ~/Library/Application Support/lowfi
• Windows - %appdata%\Roaming\lowfi

Par exemple, lowfi --track-list minipop chargera ~/.local/share/lowfi/minipop.txt. Tandis que lowfi --track-list ~/Music/minipop.txt chargera depuis le répertoire spécifié.

Tous les morceaux doivent être au format MP3, sauf si lowfi a été compilé avec la fonctionnalité extra-audio-formats, qui ajoute la prise en charge de certains autres formats.

Le format

Dans les listes, la première ligne est appelée l’en-tête, suivie du reste des pistes. Chaque piste sera d’abord concaténée à l’en-tête, puis l’ensemble sera utilisé pour télécharger le morceau.

Note

lowfi n’ajoutera pas de / entre la base et la piste pour plus de flexibilité ; dans la plupart des cas, vous devriez donc avoir un / final dans votre en-tête.

L’exception à cette règle est lorsque le nom de la piste commence par un protocole tel que https://, auquel cas la base ne sera pas préfixée. Si toutes vos pistes sont de ce type, vous pouvez mettre noheader comme première ligne et ne pas avoir d’en-tête du tout.

Par exemple, dans cette liste :

https://lofigirl.com/wp-content/uploads/
2023/06/Foudroie-Finding-The-Edge-V2.mp3
2023/04/2-In-Front-Of-Me.mp3
https://file-examples.com/storage/fe85f7a43b689349d9c8f18/2017/11/file_example_MP3_1MG.mp3

lowfi téléchargerait ces trois URL :

• https://lofigirl.com/wp-content/uploads/2023/06/Foudroie-Finding-The-Edge-V2.mp3
• https://file-examples.com/storage/fe85f7a43b689349d9c8f18/2017/11/file_example_MP3_1MG.mp3
• https://lofigirl.com/wp-content/uploads/2023/04/2-In-Front-Of-Me.mp3

De plus, vous pouvez choisir un nom d’affichage personnalisé pour une piste, indiqué par un !. Par exemple, avec une entrée comme celle-ci :

2023/04/2-In-Front-Of-Me.mp3!nom personnalisé

lowfi téléchargera depuis la première partie et affichera la seconde comme nom du morceau.

file:// peut être utilisé devant une piste ou un en-tête pour que lowfi le traite comme un fichier local. C’est utile si vous souhaitez utiliser un fichier local comme URL de base, par exemple :

file:///home/utilisateur/Musique/
fichier.mp3
file:///home/utilisateur/Musique 2/deuxieme-fichier.mp3

D’autres exemples sont disponibles dans le dossier data.