# zenmusic

**Repository Path**: emerger/zenmusic

## Basic Information

- **Project Name**: zenmusic
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-08-13
- **Last Updated**: 2024-08-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Zen Music

Zen Music is a music player, visualizer and organizer inspired by the 2000's era iTunes and the tracker music players of the early 90's.

Click on image for video introduction :
[![alt text](svg/screenshot.jpeg)](https://www.youtube.com/watch?v=bF0g5mw_2P0)

## Features ##

- retro-minimalistic UI
- beautiful and smooth UX experience
- always-on frequency and scope analyzer visualizers
- library auto-organization ( if enabled )
- activity window and human-readable database for transparent operation

Read the user guide for further information : [Open User Guide](doc/USER.md)

## Installation ##

### FreeBSD ###

```
git clone https://github.com/milgra/zenmusic.git
cd zenmusic
sudo gmake deps
gmake build
sudo gmake install
```

### Arch based Linuxes ###

```
sudo pacman -S make clang git ffmpeg sdl2 glew
git clone https://github.com/milgra/zenmusic.git
cd zenmusic
make build
sudo make install
```

### Debian based Linuxes ###
(Note: zenmusic needs OpenGL 4.0 compatible gpu drivers)

```
sudo apt install make clang git ffmpeg libsdl2-dev libglew-dev libavcodec-dev libavfilter-dev libavdevice-dev
git clone https://github.com/milgra/zenmusic.git
cd zenmusic
make build
sudo make install
```

## User Guide ##

[Open User Guide](doc/USER.md)

## Feedback ##

Please report issues and add feature requests here on github.

## Libraries used - Thanks for creating these! ##

- FFMPEG / media parsing
- SDL2 / window/graphics context handling
- stb_truetype / text generation
- Neil Hanning's utf8.h / case-insensitive utf8 comparison

## Programs used - Thanks for creating these! ##

- Inkscape for the icons
- GNU Emacs for programming
- FreeBSD for development platform

## Contribute ##

Contributors are welcome!

## Tech Guide ##

[Tech Guide](doc/TECH.md)

## Roadmap ##

[Roadmap](doc/ROAD.md)

## License ##

Zen Music is released under the GPLv3 (or later) license.