Skip to content

Latest commit

 

History

40 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Atulo

Atulo is a C program made to play audio files


Note

Atulo now supports mp3, wav, ogg, opus, aiff and flac any other format atulo wouldn't be able to play them, currently I am working on creating a decoder using ffmpeg, until then you can use atulo freely


Requirements:

  • GCC
  • miniaudio.h (embedded in the project)
  • Ncurses

Debian/Ubuntu Distros

sudo apt update
sudo apt install build-essentials  libncurses5-dev libncursesw5-dev

Fedora Distros

sudo dnf groupinstall "Development Tools"
sudo dnf install ncurses-devel

Arch Distros

sudo pacman -S base-devel ncurses

Supported OS:

  • Linux
  • MacOS (Not Tested)

How to build:

Build

Run make clean build to only build the file in the current directory you will have a binary for the program

$ make clean build

Install

Run sudo make clean install to build and move the binary to the /usr/local/bin/ directory to make it run everywhere

$ sudo make clean install

Uninstall

Run sudo make uninstall to uninstall the program

sudo make uninstall

Features:

  • Works from terminal directly
  • lightweight
  • Keyboard Focused

Usage:

Key Function
p Space Pause
q Quit
r Replay
-> Seek 5s
<- Seek 5s Backward

Configuration:

Atulo can be configured through config.h then rebuilding the source code

#ifndef CONFIG_H
#define CONFIG_H

// Keys
#define KEY_QUIT 'q'
#define KEY_REPLAY 'r'
#define KEY_PAUSE 'p'
#define SEC_KEY_PAUSE ' ' // Space
#define SK_FR_KEY 0405 // Right Arrow
#define SK_BR_KEY 0404 // Left Arrow

// Box Width & Height
#define BOX_W 80
#define BOX_H 10

// Colors (MUST FOLLOW NCURSES COLOR CODES)
#define ACCENT_COLOR_CODE 5
#define MUTED_COLOR_CODE 8

#endif

You can change the width and height of the box that contains the elements

You can change the Keybindings (NON-LETTER KEYS MUST USE THE CORRESPONDING NCURSES KEY CODES)


Issues

if you find any issues you can report at Issues


Contributing

Contributions are welcome whether they are adding new features or improving code just make your edit and make a pull request

Please make sure your pull request is well documented


License

This Project is licensed under the GPLv3 License

About

Audio Player written in C

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages