initial commit

Author: bradwbradw

README.md

@@ -0,0 +1,6 @@
+archiver
+========
+
+citr audio archiver written in C and Python - including web-interface for downloading audio chunks
+
+authored by rtav

archiver-TODO

@@ -0,0 +1,12 @@
+(1)	Reverse date format to YYYY-MM-DD
+
+(2)	Use ~ (tilde) instead of space in /arch/d
+
+(3)	If file ends in .mp3, play directly.  Otherwise, download.
+	This may be a browser-defined behavior.  We could always for
+	.mp3 include a player.
+
+(4)	Caching of requests---I suppose that once podcasts come into
+	use, this will make sense, if only to avoid unnecessary
+	latency.
+

citrlog/LICENSE

@@ -0,0 +1,15 @@
+/**
+Copyright (c) 2013, Robin Tavender
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+3. Neither the name of the Student Radio Society of The University of British Columbia nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+ */

citrlog/README

@@ -0,0 +1,64 @@
+CiTRLOG
+1.0
+
+02/01/2014
+
+by Robin Tavender.
+
+(0) INTRODUCTION
+(I) CONFIGURATION
+(II) COMPILATION
+(III) INSTALLATION
+(IV) DEBUGGING
+
+(0) INTRODUCTION
+
+CiTRLOG is a program that continuously records audio, in the case of its original composition, the audio running out of the panel in CiTR101.9 FM's transmission room.  This direct feed is recorded continuously onto a mass storage device as one-second mp3 files.  These files may be easily concatenated together, without further modification, to form continuous chunks of audio.
+
+(I) CONFIGURATION
+
+The standard configuration file template in citrlog.EDITME.ini contains a few lines that can be modified.  Once you have modified it, you may copy it wherever you like, e.g. 
+
+/usr/local/etc/citrlog.ini
+
+The lines below the comment indicating not to change the values bellow the comment should be respected, unless, of course, you have read the source code and feel confident that modifying the values will not impact functionality.  However, if you are competent to do that, you probably do not need instructions on how to configure or use this program; you should simply read the source code.
+
+(II) COMPILATION
+
+Dependencies:
+asound
+sndfile
+mp3lame
+
+Compiler:
+gcc
+
+To Compile:
+gcc -o -O3 citrlog -lasound -lsndfile -lmp3lame ini.c citrlog.c
+
+(III) INSTALLATION
+
+Copy the citrlog binary to your preferred location, along with the configuration file.  
+
+Provide for execution of the binary by your preferred method, e.g. a line in /etc/rc.local, e.g., to execute citrlog as user logger:
+
+su -c "/usr/local/bin/citrlog /usr/local/etc/citrlog.ini" logger
+
+(IV) DEBUGGING
+
+No progam is ever free of bugs.  There are, as Donald Rumself informs us, known knowns, known unknowns, and unknown unknowns. The things that we do not know we do not know are the most difficult to fix.  And often we will know something is amiss, but we will not know what it is.  If we are lucky, our problems are known knowns: we both know the problem and its cause. 
+
+If you make any modifcations to this program, I would appreciate it if you would send the modifcations to rtav@ubicee.net
+
+(V) MANIFEST
+
+sha1sum:
+
+3cfaef91674a5c8ef9df72041503899a25a15d6f  citrlog.c
+8d0bd0e1899648efc523617ada70eb95af8eb988  citrlog.EDITME.ini
+7d3273a0bfb31e10393b5d07268796647d0c4d02  ini.c
+5ea81419b91d350837c026d10ddcd20e16523919  ini.h
+04525d33050bfaf7f6a982935f51cdad0921f274  make.sh
+a08ca5b4c251f18f488f5926399e9523f356568c  README
+
+Total bytes: 34234

citrlog/checksums.sha

@@ -0,0 +1,7 @@
+3cfaef91674a5c8ef9df72041503899a25a15d6f  citrlog.c
+8d0bd0e1899648efc523617ada70eb95af8eb988  citrlog.EDITME.ini
+7d3273a0bfb31e10393b5d07268796647d0c4d02  ini.c
+5ea81419b91d350837c026d10ddcd20e16523919  ini.h
+04525d33050bfaf7f6a982935f51cdad0921f274  make.sh
+a169ba482e6ca41a40543af160735f7071f26dda  README
+

citrlog/citrlog.EDITME.ini

@@ -0,0 +1,10 @@
+[main]
+audiologbase=***EDIT ME*** (e.g. /mnt/audiolog/)
+logfile=***EDIT ME*** (e.g. /mnt/audiolog/audilog.log)
+detach=true
+#it is not recommended that you alter any of 
+#the values below this line.
+device=default
+samplerate=44100
+mp3rate=128
+buffersize=44100