NekoMC (New Efficient Kitten-oriented MPRIS Client)
a waybar/general component for displaying current song data in bars like waybar and controling players using MPRIS
MPRIS is very widely supported, so this component should work with:
- Firefox and Firefox based Browsers like Librewolf
- Browsers based on Chromium
- Spotify
- mpd (with mpDris2)
- VLC ( For People that don't use MPV in 2023 )
- Basically every other Music/Video player on the face of Earth
Install
Run sh <(curl -L https://raw.githubusercontent.com/Insert5StarName/NekoMC/main/install.sh) in your Terminal or
Get the latest release binary and move it to /usr/bin or your PATH or compile it yourself
Compile your self
Clone this Repo and Install the needed dependencies (if you use NixOS you can use nix-shell)
- Rust (Cargo, Rustc)
- Dbus
- Pkgconfig
then compile the programm with cargo build --release and then copy the file that is located at ./target/release/NekoMC to /usr/bin or your PATH
Usage
When running NekoMC with --hook-waybar it will print out the current song info in a JSON format that Waybar can use. Add something like this to your waybar config.json:
"custom/NekoMC": {
"return-type":"json",
"exec":"NekoMC --hook-waybar",
"on-click":"NekoMC --toggle",
"on-click-right":"NekoMC --next",
"on-scroll-up":"NekoMC --next",
"on-scroll-down":"NekoMC --previous",
"escape" : "true",
},
Usage: ./NekoMC [option]
NekoMC - New Efficient Kitten-oriented MPRIS Client
Options:
--hook Print currently playing song info (name, artist, status) in a Loop.
--hook-waybar Print currently playing song info in Waybar module format in a Loop.
--current-song Print currently playing song info but not looped like the first 2 options.
--play Tell the player to resume playing.
--pause Tell the player to pause.
--next Tell the player to play the next song.
--previous Tell the player to play the previous song.
--toggle Toggle between playing and pause.
7.9k Dec 31, 2022
9.3k Jan 4, 2023
19 Jun 7, 2022
23 Nov 11, 2022
19 Oct 7, 2022
88 Dec 31, 2022
8 Jul 4, 2022
223 Dec 15, 2022
6 Mar 2, 2022
4 Jun 18, 2022
2 May 13, 2022
5 Dec 18, 2022
44 Dec 30, 2022
8 Apr 19, 2023
3 Apr 26, 2023
3 Jun 23, 2021
2 Apr 1, 2022
216 Dec 25, 2022
5 Nov 21, 2022
1.7k Jan 1, 2023
7.2k Jan 2, 2023
3.4k Jan 8, 2023
4 Jun 29, 2023
12 Sep 21, 2023
18 May 22, 2022
41 Dec 22, 2022
284 Dec 13, 2022