.\" Automatically generated by Pandoc 1.19.2.4 .\" .TH "fadecut" "1" "March 2013" "" "" .hy .SS NAME .PP fadecut \- Toolset to rip audiostreams, cut, fade in/out and tag the resulting audiofiles .SS SYNOPSIS .IP .nf \f[C] fadecut\ \-p\ \ [\ OPTIONS\ ] \f[] .fi .SH DESCRIPTION .PP 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. .PP 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). .PP In file mode fadecut is just processing already ripped audio files. .PP 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. .SH FOLDERS .PP fadecut is working with some standard folders. You may change them in your profile or fadecutrc .PP \f[B]done/\f[] here you put all your songs which were already processed by fadecut and which you want to keep. See also new/ folder. .PP \f[B]dontlike/\f[] in this folder you may put songs which you don\[aq]t like. Fadecut is checking this folder before it is processing new files in the working folder. Null size files are ok. .PP \f[B]error/\f[] whenever an error occurs while fadecut is processing a file, that file is moved to the error folder for later examining. .PP \f[B]incomplete/\f[] this folder is created by streamripper. All not fully ripped songs are saved here. .PP \f[B]new/\f[] 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. .PP \f[B]orig/\f[] 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. .SH OPTIONS .PP \-c Create a new profile .PP \-e Edit an existing profile .PP \-l list all existing profiles .PP \-i optional input .PP \-o optional output .PP \-k optional to keep the untouched original song in the /orig folder .PP \-d Debug: \-d 0|1|2|3 (level 0 is standard, \-d without number is like 1) .PP \-h Show this message .PP \-p Profile .PP \-q Quiet .PP \-r Stream (and rip), start streamripper .PP \-t add Timestamp to the Filename .PP \-v Verbose .SH VARIABLES .PP URL to stream .IP .nf \f[C] STREAM_URL="http://streamurl" \f[] .fi .PP Preferred destination fileformat. (opus/ogg/mp3) .IP .nf \f[C] ENCODING=ogg \f[] .fi .PP Processed files will get the above genre. .IP .nf \f[C] GENRE="SwissPop" \f[] .fi .PP Processed files will get the above comment. .IP .nf \f[C] COMMENT="Radio\ Swiss\ Pop" \f[] .fi .PP Cut seconds off the file in the beginning. .IP .nf \f[C] TRIM_BEGIN=0 \f[] .fi .PP Cut seconds off the file at the end. .IP .nf \f[C] TRIM_END=0 \f[] .fi .PP Fade in for seconds. .IP .nf \f[C] FADE_IN=1 \f[] .fi .PP Fade out for seconds. .IP .nf \f[C] FADE_OUT=4 \f[] .fi .PP Set the user\-agent used by streamripper .IP .nf \f[C] USER_AGENT="Streamripper/1.x" \f[] .fi .SH EXAMPLES .PP Create a new ripping profile .IP .nf \f[C] fadecut\ \-c\ test \f[] .fi .PP Edit/update profile test .IP .nf \f[C] fadecut\ \-e\ test \f[] .fi .PP Rip, cut and fade in\-/out with profile test .IP .nf \f[C] fadecut\ \-p\ test\ \-r \f[] .fi .PP Only cut and fade in\-/out without ripping from livestream .IP .nf \f[C] fadecut\ \-p\ test \f[] .fi .SH SEE ALSO .PP id3v2(1), oggenc(1), opusenc(1), sox(1), streamripper(1), lame(1) .SH FILES .PP \f[I]~/.fadecut/fadecutrc\f[] is the main fadecut configuration file, executed with every start of fadecut. .PP Content of fadecutrc # which files to work on FILES=*.mp3 .IP .nf \f[C] #\ 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\[aq]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\[aq]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\[aq]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" \f[] .fi .PP \f[I]~/.fadecut/statslog.csv\f[] is the statistics file. .IP .nf \f[C] 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 \f[] .fi .PP \f[I]~/.fadecut/profiles\f[] is the folder where all profiles are located. .PP To create a profile file .IP .nf \f[C] \ \ \ \ fadecut\ \-c\ myradiostation \f[] .fi .PP Settings in the profile file .IP .nf \f[C] \ \ \ \ #\ 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 \f[] .fi .SH RESOURCES .PP fadecut git website: https://github.com/fadecut/fadecut .SH AUTHORS Martin Gafner, Marco Balmer.