> glorec
glorec
0.99

linux sound recording gui
    
let one recording microphones and/or desktop sound as wav files, with gui.
using openal, opengl, glfw3.

with a click anyplace in the window, glorec records wav files in the
current dir  ( user home dir if run with desktop menu ) 
if wanting another path it maybe passed as an arg:
🖬glorec  /path/🖬
if the path doesn't exist or cannot be used, current path  will be used
instead.

files are 16bits 44100Hz, mono, as audio cd quality (yet mono) .
resolution can be changed as 8 or 16bits, tracks as 1 or 2, mono or stereo.

files are timestamped, named as 🖬snd202002232122300.wav🖬
number is year, month, day, hour, minutes, seconds.

so there is a maximum one file/second limit.
there's also a wav file limit maximum length is max 32bits int bytes,
approximatively 13 hours (48695 seconds) per 16bits 44100Hz, mono file.
there can be as much files as the media (hard-disk, ...) can contain.



.tar.gz source package has a binary, source with compiling instructions,
icons. 






cli options
💻★glorec★ [--help][--rec][--mono|--stereo][--res INT][--hz
INT][--posx INT][--posy INT][--width INT][--height INT][PATH]💻
       🖬--help🖬 help
    🖬--version🖬 
        🖬--rec🖬 record as soon as up.
       🖬--mono🖬 mono 1 track
     🖬--stereo🖬 stereo 2 tracks
        🖬--res🖬 resolution as bytes can be 1 or 2: 1=8bits 2=16bits 
         🖬--hz🖬 sampling speed in hertz 
   🖬--next INT🖬 stop recording next INT seconds.
🖬--silence INT🖬 stop if 3 seconds silence below INT (percentage).
  🖬--noise INT🖬 start recording if sound more than INT (percentage) .
       🖬--fifo🖬 enable command fifo at /tmp/glorec.fifo
         🖬--qs🖬 quit on stop.
       🖬--posx🖬 window position x.
       🖬--posy🖬 window position y. 
      🖬--width🖬 window width.
     🖬--height🖬 window height. 
         🖬PATH🖬 recording sound files using path.


★glorec★ can be used scripting, along each recording the program prints
some infos a script could collect and reuse, as:
💻 recording /path/snd20191221132955.wav 2tracks 44100Hz 8bits💻

with 🖬--fifo🖬 option, a bash script can send commands to a running
★glorec★: 🖬rec🖬 🖬stop🖬 🖬pause🖬 🖬quit🖬
💻echo stop > /tmp/glorec.fifo💻





runtime options
while running, glorec responds some keyboard event:
========================================
      🔟F1🔟, 🔟H🔟: help       (printed in the terminal)
     🔟ESC🔟, 🔟Q🔟: exit
     🔟F11🔟, 🔟F🔟: fullscreen
🔟SPACEBAR🔟, 🔟R🔟: start/stop recording
       🔟M🔟, 🔟S🔟: mono, stereo
       🔟1🔟, 🔟2🔟: 8bits, 16bits
              🔟P🔟: pause recording
========================================






sound source
using other sources

if the distrib is using alsa, the source maybe changed with alsamixer gui:
alsamixer with F4 displays capture config. -pictures- 
source maybe changed using arrows: right towards input source, up/down
changing volume, spacebar selecting source. M mute/unmute.
desktop sound is with Input source options named as "🖬Stereo Mix🖬" or
"🖬Loopback🖬"


glorec is using openal default as a source.
openal itself maybe configured with changing
🖬/etc/openal/alsoft.conf🖬
it's probably best letting "🖬default🖬" as a source.






changes
glorec 0.99

  * stop next some time seconds    cli arg  --next SECONDS  
  * stop on silence cli arg --silence PERCENT
  * rec on volume sound cli arg --noise PERCENT 
  * code cleanup and type refactoring
  * endian-safe file writing helpers
  * fix compiler warnings
  * improved error handling for file paths and writing
  * increased path string variable size
  * stop recording on write error, allowing retry
  * added inline tag, often used functions
  * system events Ctrl+C  -> clean quit
  * quit on stop cli arg --qs
  * fifo commands (rec stop quit) listener (/tmp/glorec.fifo)
  * pause trigger (key P or fifo command 'pause')
  * pause indicator gfx

other versions, see file changelog.en.txt  





motivations
glorec

  * ★simple or no sound/sound driver config★
would work with any driver, abstracting the driver used and most its
options.
with choosing openal, its having chances to work on any machine having
functionnal gl games without having to tweak/install anything.
 
  * ★longlasting software could be used 50+years★
made with fixed/closed standards c99, opengl2, openal .

  * ★easy to compile on other machines★
only a compiler required, no build system used.
  
  * ★easy to use★
most basic functions could be made with a click or two.

  * ★monitoring sound level with precision★
would show level with precision, with clipping indication.

  * ★filemanager integration★
could be used with a file manager so as to record sound notes in current
path.

  * ★batch/scripting integratio★n
could bring sound rec options to a bash script.

  * ★scope gfx★
a scope gfx is also something fun I would like having as an eyecandy.

  *  ★multitask★ 
should be multitask compatible so as to record multiple desktop running
softwares, so few resources use, letting time each other softs.