# xlmp

**Repository Path**: EEPPEE_admin/xlmp

## Basic Information

- **Project Name**: xlmp
- **Description**: x11 local music player using libvlc(X11 vLc Music Player)
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-25
- **Last Updated**: 2026-02-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: X11, MusicDev

## README

# x11 local music player

- a simple x11 local music player which internal use libvlc to handle audio stuff
- [WARNING]: this is clanker generate application, it should expectly have bugs
- don't expected this program is too fucking useful

# screenshots

<img src="./screenshots/2026-02-25-110045_1920x1200_scrot.png"
width=auto
height=300px
/>

# build

```bash
# compile
cc -o xlmp src/*.c \
    -I include/ \
    `pkg-config --cflags --libs freetype2` \
    -lX11 -lXft -lXinerama -lm -lvlc \
    -Wall -Wextra
```

# sample usage

```bash
# if your ~/Music folder has audio files
$ ./xlmp ~/Music
Success: Scanned 21 audio files from '/home/etcix/Music/' (visible items per page: 16)
```

# keybinds

- launch the app and press `Tab` to toggle help window

# ref links

- idea was driven by alio: https://github.com/fenimore/alio
- ui style probe from: https://gitee.com/EEPPEE_admin/listviewmenu

# TODO & Bug

- whatever, at least I show the warning info, ok, this is not a bug

```bash
$ ./a.out ~/Music/audio_files_20251130/
Warning: Directory '/home/etcix/Music/audio_files_20251130/' has 4 files, but no supported audio files (supported: mp3, wav, flac, ogg, m4a, aac, wma, opus)
Floating point exception
```

- your music file always should use English text, because I don't fucking know if Chinese support or not