soundcloud-tui

KO | EN

gitlite — search

#cloud-native #self-hosted #computer-vision #terminal #javascript #automation #markdown #android #tailwindcss #linux

(★ 9)

minimalistic soundcloud tui for linux

File Explorer

ZIP Download

- - cachix.yml
- - mod.rs
  - mpv.rs
- - client.rs
  - mod.rs
  - models.rs
- - library.rs
  - mod.rs
  - nowplaying.rs
  - player_bar.rs
  - popup.rs
  - queue.rs
- app.rs
- color.rs
- config.rs
- discord.rs
- event.rs
- gradient.rs
- main.rs
- reactive.rs
- theme.rs
.envrc
.gitignore
Cargo.lock
Cargo.toml
flake.lock
flake.nix
package.nix
README.md

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

A terminal SoundCloud client written in Rust.

## Prerequisites

```bash
sudo pacman -S mpv
```

## Nix

You can run the tui directly via `nix run`:

```sh
nix run github:Mvkweb/soundcloud-tui
```

or add it to your system configuration

```nix
  {
    inputs = {
      nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable";

soundcloud-tui.url = "github:Mvkweb/soundcloud-tui";
    };
  }
```

### Add the package to environment.systemPackages inside your configuration.nix:
```nix
{ pkgs, inputs, ... }: {
  environment.systemPackages = [
    inputs.soundcloud-tui.packages.${pkgs.system}.default
  ];
}
 ```

### Rebuild your system

```
sudo nixos-rebuild switch
````

## Installation

Clone the repository and install:

```bash
git clone https://github.com/Mvkweb/soundcloud-tui.git
cd soundcloud-tui
cargo install --path .
```

Ensure `~/.cargo/bin` is in your `$PATH`.

## Usage

Launch from any terminal:

```bash
soundcloud-tui
```

### Controls

- `Space`: Play / Pause
- `n`: Skip to Next track
- `b`: Skip to Previous track
- `a`: Add highlighted track to Queue
- `Enter`: Play selected track / Select artist
- `/`: Search tracks
- `u`: Load user profile / likes
- `j` / `k` (or `Up` / `Down`): Navigate list
- `h` / `l` (or `Left` / `Right`): Switch panes
- `Tab` / `>` / `<`: Switch views (Now Playing, Lyrics, Queue, Tracks)
- `t`: Open theme picker
- `f`: Open filter / sort modal
- `+` / `-`: Volume up / down
- `q`: Quit

## Credits

Special thanks to [HaseebKhalid1507/Myx](https://github.com/HaseebKhalid1507/Myx) for inspiration!

## Uninstall

```bash
cargo uninstall soundcloud-tui
```

soundcloud-tui

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README