Synapse 🌋

---

Synapse is a lightweight terminal music player built with Rust. It brings the core features of desktop players into the CLI, powered by Vim-style keybindings. While designed specifically for NixOS and its declarative ecosystem, it can be adapted for other Linux distributions with some extra effort.

---

📸 Screenshot

---

📦 Get Started

Quick Run

You don't even need to install it. Just run:

# Run with your music directory
> nix run github:mains-hum/synapce -- ~/music

Flake

{
  inputs.synapse.url = "github:mains-hum/synapse";
  
  outputs = { self, nixpkgs, synapse, ... }: {
    nixosConfigurations.nixos = nixpkgs.lib.nixosSystem {
      modules = [
        { environment.systemPackages = [ synapse.packages.x86_64-linux.default ]; }
      ];
    };
  };
}

#Run with your music directory
> synapce ~/music

---

⭐ Star this repo if you find it helpful! Made with by mains-hum

---

📝 License

nix-dotf Copyright (C) 2025-2040 mains-hum

See the LICENSE file for details.