.TH streamripper "1" "October 2002" "streamripper" "http://streamripper.sf.net/" .SH NAME streamripper \- rip audio streams .SH SYNOPSIS .B streamripper URL [\fIOPTIONS\fR] .SH DESCRIPTION Streamripper records shoutcast compatible streams. Shoutcast style streams contain "meta data" or track separation data, it uses that as a marker for where the track should be separated, next the MP3 data is decoded and scanned for a silent point which is where tracks will be created. Finally, tracks are placed nicely on your harddrive with appropriate names and separation. .SH OPTIONS .TP \fB\-d \fR The destination directory .TP \fB\-s\fR Don't create a directory for each stream .TP \fB\-r \fR Create a relay server on base port, defaults to port 8000 .TP \fB\-z\fR Don't scan for free ports if base port is not available .TP \fB\-p \fR Use HTTP proxy server at .TP \fB\-o\fR Write over tracks from incomplete .TP \fB\-c\fR Don't auto-reconnect .TP \fB\-v\fR Print version info and quite .TP \fB\-l \fR number of seconds to run, otherwise runs forever .TP \fB\-q\fR add sequence number to output file .TP \fB\-i\fR dont add ID3V1 Tags to output file .TP \fB\-u \fR Use a different UserAgent then "Streamripper" .SH EXAMPLES The easiest way to get started is to find the URL of a stream you want to rip, usually I find the URL by loading it up in winamp or xmms and querying for the so urce URL. (right clicking on the playlist) Once you have the URL you can begin ripping. streamripper http://205.188.245.132:8038 This would rip Monkey Radio (as of 1/10/2001), it places the tracks into two directory's one called "Monkey Radio" and a sub-directory "Monkey Radio/incomplete" the incomplete directory is for tracks that streamripper does not know the begging or end of. the first and last tracks your rip for instance, would be in incomplete. Also you can listen to the stream by creating a relay server: streamripper http://205.188.245.132:8038 -r When the program starts it will display what port it's relaying the stream on, it defaults to 8000 but you can choose another port. To listen to your relay server open up XMMS or Winamp and enter your machine name with the port as you would any other stream. Very useful is the possibility to fake other clients, like Winamp, since a couple of site are blocking streamripper now. To do so, just use: streamripper http://205.188.245.132:8038 -u "xmms/1.2.5" To figure out what User-Agent other clients use, you can use netcat: netcat -l -p 8888 Now connect with your client to http://localhost:8888/ and you should see something like: .Sp .nf GET / HTTP/1.0 host: localhost User-Agent: xmms/1.2.5 x-audiocast-udpport: 32779 .Sp .fi .SH VERSION This manual page applies to streamripper version 1.32 for Unix. .SH HISTORY Streamripper was started sometime back in early 2000. Streamripper started as a way to separate tracks via Shoutcast's title-streaming feature. This has now been expanded into a much more generic feature, where part of the program only tries to "hint" at where one track starts and another ends, thus allowing a MP3 decoding engine to scan for a silent mark, which is used to find an exact track separation. Streamripper is now part of the FreeBSD standard distribution, mentioned in the Linux MP3 HOWTO, known to compile on many platforms such as Linux, Windows, FreeBSD, BeOS, OS/2. This is not surprising as portability was a constant consideration during development. With the emergence of file sharing protocols such as Napster, Gnutella, and now Mojonation and Freenet, the average Internet user can download nearly any MP3 he wants in a matter of no time, but many times people don't know what they want. Streamripper allows you to download an entire station of music. Many of these MP3 radio stations only play certain genres, so you can now download an entire collection of goa/trance music, an entire collection of jazz, punk rock, whatever you want. .SH KNOWN BUGS mpglib has the annoying habit of calling exit(1) in the middle of code i don't understand. this will kill streamripper, this happens (rarely) usually on low bitrate streams. Track separation is not an exact science, it will fail retardedly at times. So metimes streamripper hasn't buffered enough back to ever hear the previous track , other times the track has a pockets of silence in he beginning and end, hopefully it works well 95% of the time. .SH REPORTING BUGS Please report bugs to the Bug Tracking System at the streamripper homepage. .SH AUTHORS Streamripper 1.32 by Jon Clegg Manual page by Alexander W. Janssen , most parts are shamelessly ripped of the streamripper-documentation or from the website. .SH RESOURCES .TP .B http://streamripper.sf.net/ Streamripper homepage .TP .B http://lists.sourceforge.net/lists/listinfo/streamripper-general Streamripper mailing list .TP .B http://freshmeat.net/projects/netcat/ Netcat at Freshmeat .TP .B http://www.shoutcast.com/ Shoutcast .TP .B http://www.icecast.org/ Icecast .TP .B http://www.shoutclub.com/ ShoutClub .SH LICENSE Streamripper is released under the terms of the GNU General Public License Version 2. See COPYING for details.