termitune 0.1.0

# termitune

A fast, lightweight, keyboard-driven terminal music player in Rust for unix systems.

## Features

- **File Browser** - Navigate directories and browse audio files
- **Audio Metadata** - Displays title, artist, and duration
- **Queue System** - Add tracks to queue and manage playback
- **Playback Controls** - Play/pause, next/previous track
- **Volume Control** - Adjust volume with +/- keys
- **Progress Bar** - Track progress with time display

## Installation

### 1. Install Rust

```bash
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
```

Then restart your terminal.

### 2. Install System Dependencies

#### Debian/Ubuntu

```bash
sudo apt-get update
sudo apt-get install build-essential pkg-config libasound2-dev
```

#### Fedora

```bash
sudo dnf update
sudo dnf install gcc pkgconfig alsa-lib-devel
```

#### Arch Linux

```bash
sudo pacman -Sy
sudo pacman -S base-devel alsa-lib
```

#### macOS (untested)

```bash
brew install pkg-config
# Note: Additional audio library setup may be required on macOS
```

### 3. Build & Run

```bash
# Clone the repository
git clone https://github.com/ohmygodashish/termitune.git
cd termitune

# Build release version
cargo build --release

# Run
cargo run --release
```

## Keyboard Shortcuts

| Action | Key |
|--------|-----|
| Move up/down | Up/Down arrows |
| Enter directory / Play track | Enter or Right arrow |
| Go back | Backspace or Left arrow |
| Add to queue | Space |
| Play/Pause | p |
| Next track | n |
| Previous track | b |
| Volume up | + |
| Volume down | - |
| Quit | q |

## Supported Audio Formats

- MP3
- FLAC
- WAV
- OGG
- M4A
- AAC
- WMA

## License

[MIT License](LICENSE)