ATULO

AUDIO PLAYER WRITTEN IN C

A small terminal program made to play audio files.

[ SOURCE CODE ]

01 / FORMATS

MP3

WAV

OGG

OPUS

FLAC

AIFF


02 / INTERFACE

Atulo works directly from the terminal. Its interface is built with ncurses and its audio support comes from the embedded miniaudio.h library.

Atulo terminal interface preview

03 / CONTROLS

p / Space Pause
q / Escape Exit
r Replay from start
→ Skip 5 seconds
← Go back 5 seconds

04 / BUILD

BUILD

$ make clean build

INSTALL

$ sudo make clean install

UNINSTALL

$ sudo make uninstall

05 / CONFIGURATION

Atulo can be configured through config.h. After making changes, rebuild the source code for them to take effect.

#ifndef CONFIG_H
#define CONFIG_H

#include <ncurses.h>

#define KEY_QUIT 'q'
#define KEY_REPLAY 'r'
#define KEY_PAUSE 'p'
#define SEC_KEY_PAUSE ' '

#define SK_FR_KEY KEY_RIGHT
#define SK_BR_KEY KEY_LEFT

#define BOX_W 80
#define BOX_H 10

#define ACCENT_COLOR_CODE 5
#define MUTED_COLOR_CODE 8

#endif

BOX SIZE

Change BOX_W and BOX_H to adjust the width and height of the interface box.

KEYBINDINGS

Keybindings can be customized. Non-letter keys MUST use their corresponding ncurses key codes.

COLORS

Colors can be customized using valid ncurses color codes.


06 / REQUIREMENTS

GCC

ncurses

miniaudio.h

EMBEDDED