Streamripper:
Downloads:
Streamripper front ends:
Streamripper add-ins:
Older front ends:
StreamripperX (OSX)
Streamripper32 (Win32)
These projects are "dead" and unsupported

Documentation:
Support:
Development:
Contact:

Please ask Streamripper
questions at the forum
as this helps everybody


Valid HTML 4.01!

SourceForge.net Logo

   Frequently Asked Questions      Documentation   
If you don't see an answer to your question try asking the forum, or searching through its archive.

Q: What can I use Streamripper for?   
A: You can use it to rip (copy) streams of the following kinds:
  1. .mp3 Shoutcast streams - the kind of streams found on shoutcast.com.
  2. .mp3 Icecast streams - a GNU GPL/Open Source version of Shoutcast. Both Icecast 1.x and Icecast 2.x are supported. However, UDP metadata is not supported for Icecast 1.x.
  3. .nsv (Nullsoft Streaming Video) streams - which Winamp tv uses.
  4. .aac Shoutcast/Icecast streams - the kind of streams found on tuner2.com. NOTE: Streamripper can't rip RealAudio AAC streams, only shoutcast/icecast AAC.
  5. .ogg streams - these streams are found at dir.xiph.org.
Streamripper can't help with ripping stuff like RealPlayer, Windows MediaPlayer, MusicMatch or anything else similar.

Q: Can streamripper record Windows Media streams?   
A: No.

Q: Can streamripper record RealAudio streams?   
A: No.

Q: Can streamripper record LastFM?   

Q: Can streamripper record AOL music streams?   
A: No. Although they look like shoutcast, they are actually ultravox.

Q: Can streamripper record Peercast streams?   
A: Yes. Run the peercast client, then set streamripper to listen to the local stream.

Q: Can streamripper record Live365 streams?   
A: Yes, but it cannot separate tracks for you.

Live365 threatened a lawsuit if Streamripper did not disable ripping from their site. There's more about this in 'History (old news)' (in the menu on the left) if you scroll down a bit, including the cease and desist letter.

Q: Does streamripper work with Winamp 2?   
A: Yes. The streamripper plugin works with both Winamp 2 and Winamp 5. There is a separate plugin for Winamp 3, but this is no longer supported.

Q: How can I make streamripper rip to a single large file instead of a lot of little files?   
A: Use the -a flag to rip to a single large file. Use the -A flag to disable the creation of the little files.

In the winamp plugin, you would need to check "Rip to single file" and uncheck "Rip to separate files."

Q: How can I schedule streamripper to record at a certain time?   
A: You need the command line version to do this. Please read fecund's tutorial on streamripper automation.

Q: I closed Streamripper and now I can't find it!   
A: Don't worry; it happens to lots of guys. Load up Winamp, then look for a little 'SR' icon in your system tray. Double click on that and Streamripper should come up. This happens because when you "close" Streamripper it hides itself in the system tray. Maybe this isn't the best way to do it, but I can't think of a better way.



If that doesn't work goto the '\Program Files\Winamp\Plugins' directory and delete the sripper.ini file (Streamripper has been known to position itself outside of the viewable window), this will reset any settings, including the window position.

Q: How does Streamripper know when to split the tracks?   
A: The track data is sent at a set interval called the 'MetaInt' or meta-data interval. The rate of updates varies, but it's usually 8,192 or 24,576.
	         M1          S                         M2
	_________|___________|_________________________|________
	 Track A                           Track B              
The 'S' represents where the tracks actually switch, 'M1' and 'M2' are Meta updates. In this diagram M1 would read 'Track A', and M2 would read 'Track B'. So our best guess is that somewhere between M1 and M2 the track actually changed.

Streamripper then tries to detect a silent spot between the tracks. It decodes the mp3 data between M1 and M2 and looks at the volume. This works reasonably well for streams that do not use crossfading between tracks.

If there is not a clear silent point, the splitting point will probably not be so accurate. This happens when the station uses crossfading, or for some reason the silence between the tracks just wasn't very clear.

Q: How can I deal with streams that send bogus metadata.   
A: Some streams send metadata that does not contain track information, which I call bogus metadata. Examples of bogus metadata include station announcements, or advertisements for future shows. In winamp, the bogus metadata is useful, because it appears briefly in the display window. But it can cause problems because streamripper thinks the track has changed.

There are two strategies for dealing with bogus metdata. The first strategy is to record the songs to a single file. Then, you can easily delete the metadata from the associated cue file afterward.

The second strategy is to use the parse rules to filter out the bogus metadata. To do this, you need to edit the file parse_rules.txt that came with the distribution. Then you need to add rules that describe the metadata you want to ignore. Below is an example of a rule that ignores metadata:

# Ignore metadata that begins with "A suivre"
# The leading "m" says this is a match rule
# The trailing "e" means drop the metadata
m/^A suivre:/e

The part between the "m/" and the "/e" is a regular expression. You can read more about regular expressions here.

Q: How do I send my username and password to the proxy?   
A: http://username:password@server:port

Q: My username is my email address with an "@" sign. How can I rip password protected streams?   
A: You have to "percent-encode" the "@" sign. Percent encoding works by subsituting "%XX" for the character you want to replace, where XX is the ASCII hex code for the character. In the case of "@", the ASCII code is hex 40. So you replace "%40" for @ in the username.

For example, if my username is greg@example.com, I would use the following URL:

http://greg%40example.com:password@server:port

Q: Why do I get 'SR_ERROR_NOT_SHOUTCAST_STREAM' when trying to connect to my stream?   
A: There are a few reasons why one might get this error:
  1. It's not a Shoutcast stream, but it's some other type of stream Streamripper doesn't know how to handle.
  2. The stream is blocking players that don't have a 'Winamp/2.x' UserAgent.
The first thing to try is changing the Streamripper UserAgent setting to something else (try 'WinampMPEG/5.0' or 'iTunes/4.7 (Macintosh; N; PPC)' or 'RMA/1.0 (compatible; RealMedia)'). If this doesn't work, right click on the stream Playlist entry in winamp and select 'File Info' and make sure it's a Shoutcast stream.

Q: Why do I get 'SR_ERROR_CANT_CREATE_FILE' when trying to rip a stream?   
A: There are a few reasons why one might get this error:
  1. You're using a version older than 1.60.6. If so, please upgrade.
  2. You're using 1.63-beta-2. Please use a different version.
  3. You're ripping a stream with non-English song titles. If this is the case, you can try making sure that your default locale (regional settings in windows) matches the language of the stream you are ripping.
If this doesn't solve your problem make a post at the forum.

Q: Streamripper doesn't load. I get a "(NOT LOADED)" in Winamp   
A: You're running windows 95. You should get the Winsock2 update from Microsoft. That should fix it.

Q: Where's the source?   
A: To get the complete source (including winamp plugin), download from the sourceforge CVS repository. Instructions on how to retrieve the source from CVS can be found here. If you don't want to deal with CVS, the Unix versions includes the source with the download, but this doesn't include the winamp plugin code.

Q: Why don't I get separate files?   
A: Probably because the stream doesn't contain meta-data. Steamripper knows how to get track data from Shoutcast streams with meta-data. If it's a Shoutcast stream and you don't see the track names when you play in Winamp, then Streamripper won't know either.

Q: What's meta-data?   
A: Meta-data means track data. I use the word meta a lot because in the Shoutcast server HTTP response header it has something called "meta-int" (meaning meta interval) which is often how meta/track data is sent in the stream.

Q: How does Streamripper get the track data/meta-data from Shoutcast streams?   
A: I would really like to spend a day or two and write a formal doc on how this works. But the skinny is that for every x bytes (specified by the meta-int HTTP field) Shoutcast servers send the track data. If the track hasn't changed it sends a NULL byte. If there is track data you'll get a number > 0, which is the length of the meta data divided by 16. The multiplier is so they can fit the size within one byte. The meta-data field has two fields "StreamTitle" and "StreamURL". StreamURL IMO is useless, however the StreamTitle is the track name, and is used to make the separate tracks.

Q: So meta-data has nothing to do with ID3?   
A: Meta-data has nothing to do with ID3.

Q: Is there a reference document for shoutcast?   
A: Not really. But you can look at this link: radiotoolbox forum post.

Q: Ack! Streamripper is doing something weird/buggy   
A: Cool. Report it as a bug at the forum. Even better get the latest CVS and fix the bug, then submit the patch.

Q: How do I uninstall Streamripper?   
A: Modern versions of streamripper come with an uninstaller. But if you have an older version, or the uninstaller doesn't work, you might need to remove it by hand.

Q: Uninstalling the Streamripper console/command prompt   
A: Go to wherever you placed the 'consoleWin32.exe' file (do a search for it if neccessary), and remove it.

Q: Uninstalling the Streamripper plugin for Winamp 2.x (through version 1.62.3)   
A: Go to the 'Winamp\Plugins' directory and delete the 'gen_sripper.dll' file
If you really want to purge your system you can also delete the 'sripper.ini' file (in the same folder), and the 'SrSkins' directory (1.50 and later)

Folder structure Winamp 2.x:

Winamp
Plugins <<< gen_sripper.dll & sripper.ini here
Skins
SrSkins <<< SR skin files here


Q: Uninstalling the Streamripper plugin for Winamp3   
A: Go to the 'Winamp3\Wacs' directory and delete the 'sripper.wac' file
If you really want to purge your system you can also delete the 'sripper.ini' file (in the 'Winamp3' folder)

Folder structure Winamp 3:

Winamp 3 <<< sripper.ini here
... a bunch of other folders
Wacs <<< sripper.wac here


Q: Uninstalling the Streamripper32 standalone   
A: I'm pretty sure this is what to do...

You probably have a Start Menu folder named "StreamRipper32". Delete it and its contents (it contains at least one file "StreamRipper32" (a link to the program itself), and perhaps a playlist file called "relay.m3u").

You probably have a Program Files folder named "StreamRipper32". Delete it and its contents (it contains the following files: "authors", "copying", "install", "Readme", "stream2.jpg", "Streamripper_wireframeGFX.jpg", "StreamRipper32.exe", and "streamripper32.html").

In addition you'll have a file called "StreamRipper32.INI" somewhere (probably in your %systemroot% folder). To find it I'd do a search for it on your computer (on most Windows versions right-click the "Start" button on your taskbar (the button you use to start most programs) and choose something called "Search..." or similar). Delete the file.

For those who feel comfortable with the registry one can do more...

Q: Could Streamripper have feature 'x'?   
A: Probably, submit feature requests at the forum.

Q: How can I help?   
A: Download the latest CVS and get busy, implement a feature, fix a bug then send me a patch. If you do this enough I'll add you to the developer list.

Link to Streamripper!   Link to Streamripper!   Link to Streamripper!