From 59d9d61272da150fe5de481a4af68da0e74f3cde Mon Sep 17 00:00:00 2001 From: Tal <83217276+talwat@users.noreply.github.com> Date: Thu, 16 Oct 2025 13:50:36 +0200 Subject: [PATCH 1/4] docs: reate CONTRIBUTING.md --- CONTRIBUTING.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100644 CONTRIBUTING.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..3dab0ed --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,26 @@ +# Contributing to lowfi + +There are a few guidelines outlined here that will make it more likely for your PR to be accepted. +Only ones that are less obvious are going to be listed. If you need to ask, it's probably a no. + +## 1. No AI + +You can use AI for searching and so on, and if there's something minor and tedious that you'd like +the AI to write then that's okay, but if it is noticable that you used AI then it is way too much. +If you used AI, you aren't helping any maintainer by submitting your slop, it's just a hassle for them. + +## 2. Smaller is better + +Try and make it so that each PR is one contained feature. Adding multiple features in a PR is usually a bad idea. +This is also so that individual features can be approved or denied, rather than that having to be for a more significant +chunk of code. + +## 3. Keep lowfi simple + +lowfi is supposed simple program. For now, no changes to the initial user-facing UI will be accepted. +The UI of lowfi playing a song has stayed identical since the first versions, since complicating it +detracts from it's purpose. + +More complex features, like fancy colors or cover art, will not be accepted ever. Implementations of +acceptable features should also be simple and not too obtrusive. Even if a feature is simple, +if it is very complex to implement, then it won't be accepted. From 563dc67b35fe491d40f0d92e3e6438e1060f189f Mon Sep 17 00:00:00 2001 From: Tal <83217276+talwat@users.noreply.github.com> Date: Thu, 16 Oct 2025 13:51:52 +0200 Subject: [PATCH 2/4] docs: fix casing From d8e4891968d7b9b47325f76d9709835e17719732 Mon Sep 17 00:00:00 2001 From: talwat <83217276+talwat@users.noreply.github.com> Date: Wed, 22 Oct 2025 13:49:05 +0200 Subject: [PATCH 3/4] docs: add section about bookmarks --- README.md | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 396d945..025e91e 100644 --- a/README.md +++ b/README.md @@ -51,10 +51,11 @@ cargo install lowfi --features mpris ``` and making sure `$HOME/.cargo/bin` is added to `$PATH`. +Also see [Extra Features](#extra-features) for extended functionality. ### Release Binaries -If you're struggling or unwilling to use cargo, you can just download +If you're struggling or unwilling to use cargo, you can just download the precompiled binaries from the [latest release](https://github.com/talwat/lowfi/releases/latest). ### AUR @@ -129,14 +130,22 @@ Yeah, that's it. > Besides its regular controls, lowfi offers compatibility with Media Keys > and [MPRIS](https://wiki.archlinux.org/title/MPRIS) (with tools like `playerctl`). > -> MPRIS is currently an optional feature in cargo (enabled with `--features mpris`) +> MPRIS is currently an [optional feature](#extra-features) in cargo (enabled with `--features mpris`) > due to it being only for Linux, as well as the fact that the main point of > lowfi is it's unique & minimal interface. +### Bookmarks + +Bookmarks are lowfi's extremely simple answer to "what about if I'd like to save a track." +You can bookmark/unbookmark tracks with `b`, and play them with `lowfi -t bookmarks`. + +From a technical perspective, your bookmarks are no different to any other track list, +and as such are also stored in the same directory. + ### Extra Flags If you have something you'd like to tweak about lowfi, you use additional flags which -slightly tweak the UI or behaviour of the menu. The flags can be viewed with `lowfi help`. +slightly tweak the UI or behaviour of the menu. The flags can be viewed with `lowfi --help`. | Flag | Function | | ----------------------------------- | --------------------------------------------------- | @@ -173,7 +182,7 @@ This is only relevant to those using a custom track list, in which case it allows for more formats than just MP3. Those are FLAC, Vorbis, and WAV. These should be sufficient for some 99% of music files people might want to play. -If you dealing with the 1% using another audio format which is in +If you are dealing with the 1% using another audio format which is in [this list](https://github.com/pdeljanov/Symphonia?tab=readme-ov-file#codecs-decoders), open an issue. ### Custom Track Lists From adde9c42abf2852280a84d0acddee5211795c2e0 Mon Sep 17 00:00:00 2001 From: danielwerg <35052399+danielwerg@users.noreply.github.com> Date: Thu, 13 Nov 2025 23:24:03 +0300 Subject: [PATCH 4/4] chore(chillhop): remove tracks with lyrics (#107) * chore(chillhop): remove Fall Down (9262) lyrics * chore(chillhop): remove tracks with lyrics --- data/chillhop.txt | 4 ---- src/scrapers/chillhop.rs | 4 ++-- 2 files changed, 2 insertions(+), 6 deletions(-) diff --git a/data/chillhop.txt b/data/chillhop.txt index ccbcd8f..9b589c3 100644 --- a/data/chillhop.txt +++ b/data/chillhop.txt @@ -83,7 +83,6 @@ https://stream.chillhop.com/mp3/ 9201!Skyrate 8349!Isla Bella 8303!Indelible -8730!Everydayluvin 9252!Yesorno 9249!Remember 8412!Nomatter @@ -176,7 +175,6 @@ https://stream.chillhop.com/mp3/ 8425!Silience 8447!Phase 8548!Fall Down - Instrumental -9262!Fall Down 8551!Fira 8494!Gone Again 8489!Evening Routine @@ -219,7 +217,6 @@ https://stream.chillhop.com/mp3/ 8756!Away with the Fairies 8473!Melting Ice 8781!All Us -9372!Love from NGC 7318 8554!Faces 8005!Interstellar 7998!Stay. @@ -1039,7 +1036,6 @@ https://stream.chillhop.com/mp3/ 30130!Leaf Contour 30137!Reunion 30141!Repent -30131!Letters 30308!Green Tea 30140!Riverside 31601!Solitude diff --git a/src/scrapers/chillhop.rs b/src/scrapers/chillhop.rs index 978ee0f..65810ae 100644 --- a/src/scrapers/chillhop.rs +++ b/src/scrapers/chillhop.rs @@ -121,8 +121,8 @@ pub async fn scrape() -> eyre::Result<()> { const IGNORED_TRACKS: [u32; 20] = [ // 404 74707, // Lyrics - 21655, 21773, 8172, 55397, 75135, 24827, 8141, 8157, 64052, 31612, 41956, 8001, 9217, - 55372, // Abnormal + 21655, 21773, 8172, 55397, 75135, 24827, 8141, 8157, 64052, 31612, 41956, 8001, 9217, 8730, + 55372, 9262, 30131, 9372, // Abnormal 8469, 7832, 10448, 9446, 9396, ];