These utilities are intended to be simple, easily sandboxed, pipeline components for audio processing, using the au(7) file-format as an intermediary.

kd 3558addc22 Update the `README' 5 years ago
read 4005d1f808 Recreate the repository 5 years ago
write 4005d1f808 Recreate the repository 5 years ago
LICENSE 1625a80cb5 Change LICENSE to 0BSD 5 years ago
Makefile 86faba1a77 Refactor `default' 5 years ago
README 3558addc22 Update the `README' 5 years ago
adev.h 138cbb2ac3 Add aualsa(1) and auportaudio(1) 5 years ago
alsa.c 1dd5dcf4ff Fix the use of an incorrect function 5 years ago
au.7 4005d1f808 Recreate the repository 5 years ago
au.c 4005d1f808 Recreate the repository 5 years ago
au.h 4005d1f808 Recreate the repository 5 years ago
au2file.1 4005d1f808 Recreate the repository 5 years ago
au2file.c ae0c77dcf9 Correct long lines 5 years ago
auconv.1 4005d1f808 Recreate the repository 5 years ago
auconv.c d57d6acb46 Fix definitions of `NAMEMAX' 5 years ago
audev.1 4005d1f808 Recreate the repository 5 years ago
audev.c d57d6acb46 Fix definitions of `NAMEMAX' 5 years ago
audio.c 4005d1f808 Recreate the repository 5 years ago
auinfo.1 4005d1f808 Recreate the repository 5 years ago
auinfo.c 4005d1f808 Recreate the repository 5 years ago
aumix.1 4005d1f808 Recreate the repository 5 years ago
aumix.c ae0c77dcf9 Correct long lines 5 years ago
auopen.1 4005d1f808 Recreate the repository 5 years ago
auopen.c 4005d1f808 Recreate the repository 5 years ago
auresample.1 4005d1f808 Recreate the repository 5 years ago
auresample.c 138cbb2ac3 Add aualsa(1) and auportaudio(1) 5 years ago
autone.1 138cbb2ac3 Add aualsa(1) and auportaudio(1) 5 years ago
autone.c 138cbb2ac3 Add aualsa(1) and auportaudio(1) 5 years ago
common.c 4005d1f808 Recreate the repository 5 years ago
common.h 4005d1f808 Recreate the repository 5 years ago
file2au.1 4005d1f808 Recreate the repository 5 years ago
file2au.c ae0c77dcf9 Correct long lines 5 years ago
oss.c 4005d1f808 Recreate the repository 5 years ago
portaudio.c 138cbb2ac3 Add aualsa(1) and auportaudio(1) 5 years ago
sdl.c 65df6bf300 Use `SDL_events' and receive `SDL_AUDIODEVICEREMOVED' 5 years ago
sndio.c 4005d1f808 Recreate the repository 5 years ago

README

These utilities are intended to be simple, easily sandboxed, pipeline
components for audio processing, and the `au(7)' file-format is used as
an intermediary because of its simplicity.

Building:
Automatically build a majority of utilities:
$ make
cc -o auconv au.c common.c auconv.c
...

Build all possible utilities with some automatic configuration:
$ make all-magic
cc -o auconv au.c common.c auconv.c
...

Build a specific utility with some automatic configuration:
$ make auconv-magic
cc -o auconv au.c common.c auconv.c

Build a specific utility:
$ make auconv
cc -o auconv au.c common.c auconv.c

Install built utilities to the `PREFIX'
specified in the `Makefile':
$ make install
install -m 444 au.7 /usr/local/man/man7/
install -m 755 auconv /usr/local/bin/
install -m 444 auconv.1 /usr/local/man/man1/
...

Install built utilities to your `HOME' directory:
$ make install-local
install -m 755 auconv /home/user/bin/
...

Makefile Options:
PREFIX - Install-path prefix. (ex. `/usr/local')
MANDIR - The man-page sub-directory. (ex. `share/man')

C Macros:
`USE_CAPSICUM' & `USE_PLEDGE' are automatically added by
default `make(1)' target, when applicable.

BSIZE - The default buffer size.
USE_CAPSICUM - Use capsicum(4) for process restriction.
USE_PLEDGE - Use OpenBSD pledge(2) for process restriction.
NAMEMAX - The maximum size for the program name
(used in the buffer in the `SIGINFO' handler)
CBSIZE - The size of the command buffer in file2au(1)

AUOSS_DSP - The default /dev/dsp* device for auoss(1)
SDL_BSIZE - The size of the internal buffer in ausdl(1)

Portability:
The `Makefile' uses `pkg-config(1)' and `install(1)'.
`au2flac(1)' and `flag2au(1)' uses `libFLAC'.
`au2vorbis(1)' and `vorbis2au(1)' uses `libogg', `libvorbis',
`libvorbisfile', and `libvorbisenc'.
`mpg2au(1)' uses `libmpg123'.
`au2mpg(1)' uses `libmp3lame'.
`aualsa(1)' uses `libasound'.
`auaudio(1)' uses `sys/audioio.h'.
`auoss(1)' uses `sys/soundcand.h' or `libossaudio'.
`auportaudio(1)' uses `libportaudio'.
`ausdl(1)' uses `libSDL2'.
`ausndio(1)' uses `libsndio'.
`err(3)' and `sysexits(3)' are frequently used.
`getprogname(3)' and `setprogname(3)' are used.
When `USE_CAPSICUM' or `USE_PLEDGE' are specified their
corresponding interfaces are used.