Provided by: fadecut_0.2.1-1_all 
DESCRIPTION
fadecut is a script to rip audio files from a livestream (using stream- ripper) and to
process them automatically. Beginning and ending fo the audio files will be cut and faded
in/out. So logos and advertising of radio stations will be automatically removed.
In streaming mode fadecut is ripping audio files using streamripper. The downloaded audio
files are cutted using silence detection and then faded in and out. Subsequently, the
files are encoded to either ogg or mp3 and tagged with tags (title, artist, genre and
comment provided).
In file mode fadecut is just processing already ripped audio files.
An audio file which has already been processed is detected and will not be processed
again. Not desired songs can be stored in a separate directory. This files are not
processed anymore too.
FOLDERS
fadecut is working with some standard folders. You may change them in your profile or
fadecutrc
done/ here you put all your songs which were already processed by fadecut and which you
want to keep. See also new/ folder.
dontlike/ in this folder you may put songs which you don't like. Fadecut is checking this
folder before it is processing new files in the working folder. Null size files are ok.
error/ whenever an error occurs while fadecut is processing a file, that file is moved to
the error folder for later examining.
incomplete/ this folder is created by streamripper. All not fully ripped songs are saved
here.
new/ processed songs are going here. Usually you may rip and process files with fadecut,
they are going in to new/ folder, you listen to them and put good songs to the done/
folder.
orig/ if you want to keep the original file (which is ripped by stream-ripper), you may
use the -k option. fadecut is putting the ripped files untouched into that folder.
OPTIONS
-c Create a new profile
-e Edit an existing profile
-l list all existing profiles
-i optional input
-o optional output
-k optional to keep the untouched original song in the /orig folder
-d Debug: -d 0|1|2|3 (level 0 is standard, -d without number is like 1)
-h Show this message
-p Profile
-q Quiet
-r Stream (and rip), start streamripper
-t add Timestamp to the Filename
-v Verbose
VARIABLES
URL to stream
STREAM_URL="http://streamurl"
Preferred destination fileformat. (opus/ogg/mp3)
ENCODING=ogg
Processed files will get the above genre.
GENRE="SwissPop"
Processed files will get the above comment.
COMMENT="Radio Swiss Pop"
Cut seconds off the file in the beginning.
TRIM_BEGIN=0
Cut seconds off the file at the end.
TRIM_END=0
Fade in for seconds.
FADE_IN=1
Fade out for seconds.
FADE_OUT=4
Set the user-agent used by streamripper
USER_AGENT="Streamripper/1.x"
EXAMPLES
Create a new ripping profile
fadecut -c test
Edit/update profile test
fadecut -e test
Rip, cut and fade in-/out with profile test
fadecut -p test -r
Only cut and fade in-/out without ripping from livestream
fadecut -p test
SEE ALSO
id3v2(1), oggenc(1), opusenc(1), sox(1), streamripper(1), lame(1)
FILES
~/.fadecut/fadecutrc is the main fadecut configuration file, executed with every start of
fadecut.
Content of fadecutrc # which files to work on FILES=*.mp3
# target format [ogg/mp3]
ENCODING=mp3
# --- Defaults for the profiles ---
# trim n seconds at beginning
TRIM_BEGIN=0
# trim n seconds at end of song
TRIM_END=0
# seconds to fade in
FADE_IN=0
# seconds to fade out
FADE_OUT=0
# --- Directories ---
# main directory of fadecut
PWD=$(pwd)
# where to write logfiles
LOGDIR=/tmp
# profiledir
PROFILEDIR="$HOME/.fadecut"
# workdir
WORKDIR="$PWD"
# where to put fadecut'ted files
OUTPUTDIR="$PWD/new"
# where to put original files
ORIGDIR="$PWD/orig"
# here the user puts finished files, which are
# tested and listened
DONEDIR="$PWD/done"
# here are songs we don't like
DONTLIKEDIR="$PWD/dontlike"
# files had an error
ERRORDIR="$PWD/error"
# here to put temporary files
TMPDIR=/tmp
# --- Other options ---
# enqueue to rhythmbox or vlc
ENQUEUE=0
# keep or don't keep original files
KEEPORIG=1
# debug level 0-3
DEBUG=0
# verbosity level
VERBOSE=1
# loop interval in seconds
LOOP_INTERVAL=10
# restart interval streamripper
RESTART_STREAMRIPPER_INTERVAL=900
# start streamripper [0/1]
STREAMRIPPER_START=0
# streamripper useragent
USER_AGENT="Streamripper/1.x"
# streamripper options
STREAMRIPPER_OPTS="-o always -T"
~/.fadecut/statslog.csv is the statistics file.
Contains a table of processed files
Format:
Date dd.mm.yyyy;Time hh:mm:ss;Artist;Songtitle;Genre;profile;fadecut-task;filename
Example:
09.05.2014;10:14:54;Androcell;Hindu Kush;Lounge;alounge;processing;androcell_-_hindu_kush.ogg
~/.fadecut/profiles is the folder where all profiles are located.
To create a profile file
fadecut -c myradiostation
Settings in the profile file
# url to the radio stream:
STREAM_URL="http://streamurl"
# mp3-genre which will be written to the downloaded mp3-files
GENRE="Pop"
# comment which will be written to the downloaded mp3-files
COMMENT="Radio station comment"
# how many seconds to fade in the song
FADE_IN=1
# how many seconds to fade out the song
FADE_OUT=4
# how many seconds to cut from the beginning of the song
TRIM_BEGIN=0
# how many seconds to cut at the end of the song
TRIM_END=0
RESOURCES
fadecut git website: https://github.com/fadecut/fadecut
AUTHORS
Martin Gafner, Marco Balmer.
March 2013 fadecut(1)