Garry's Mod

Garry's Mod

2,099 ratings
3D Stream Radio
Type: Tool, Addon
Tags: Fun, Roleplay
File Size
4.849 MB
Apr 7, 2014 @ 5:27am
Jul 20 @ 1:06pm
153 Change Notes ( view )

Subscribe to download
3D Stream Radio

The 3D Stream Radio is an spawnable scripted entity that allows you to play streams from the internet and local files in 3D world sound. You spawn it with the toolgun, which allows you to change the its settings aswell.

FAQ (Read this before asking):
[Help] FAQ (Read this for help!)

Nothing. However Wiremod (GitHub)[] (Workshop) is highly recommended.

- Serverside playlists
- Playlist browser built into entity
- Playlist support for *.pls, *.m3u, *.json and *.vdf
- Playlist support for these addons: MX Radio, Web Radio, PatchPlay
- Model support for these addons: [NM] Prop Pack, Fallout 3 Jukebox Model, Minecraft SWEP
- Build-in playlist editor
- Wiremod support (inputs and outputs, advanced wiremod support when the optional gm_bass3[] is installed on the server.)
- 3D world sound, which can be turned off
- Customizable GUI colors
- Multiple radio models
- FFT Spectrum visualizer and music animated models
- CPPI support
- Duplicator support
- Supports local files (inside the ".../garrysmod/sound/" folder)
- Clientside performance settings
- An API for developers (Documentation, a kind of[]).

Adding playlists:
You use the playlist editor if you are an admin.
The playlist files are stored on the server at ".../garrysmod/data/streamradio/playlists/".

ConVars and ConCommands:
[Help] ConVars and ConCommands

[Help] Wiremod input and outputs

Facepunch Thread:

GitHub version:

It is optional for server (Advanced Wiremod Outputs) and client.

[Help] FAQ (Read this for help!)

Code: Grocel
Models: SligWolf


This work is licensed under a Creative Commons Attribution-NonCommercial 4.0 International License.[]

Alternatives to this addon:
Media Player - Plays video and music files on a screen entity
Web Radio - Simple radio entity

Please give feedback and report bugs below.

BUT, please report your bugs detailed. An undetailed report is invaild and can't be treated.
If you get a error message and you don't know what to do, you should always include it in your question. URLs that are giving errors should be named in your report too.
Questions that can be answered by reading this description will be answered with "read the description"!

If you have a problem using the radio, please read the FAQ before commenting.

Please don't add me to just report a bug. Please use the comment section below. If you still think you need to add me, then ask me in the comment section or in my profile first. I explain only once. Crap and idiot comments will be deleted.
Popular Discussions View All (50)
15 hours ago
PINNED: [Community] You want a new station to be added as default? Put it here.
May 26 @ 12:42am
PINNED: [Notice] Two Words about YouTube support!
Jul 17 @ 7:30am
PINNED: [Help] Troubleshooting and bug reports
< >
Grocel  [author] Jul 10 @ 8:49am 
I will think about that text editor thing. However as it is not a full time project it will a while until I got the time for that.
Grocel  [author] Jul 10 @ 8:45am 
That it plays to the speakers instead of speakers is a known bug of the BASS sound engine the game uses to do the radio streaming. This can not be fixed by the addon. Restart the game after changing/switching sound hardware and the playback should be fine.
Chris Jul 10 @ 8:17am 
It would certainly be convenient however for the playlist editor UI to support this feature.

I have one other question though: occasionally when playing Garry’s Mod, the audio produced by my radio is played through my PC speakers instead of my headset, and if another player’s radio is present, I hear its audio played through my headset as intended. Why does this occur?
Chris Jul 10 @ 8:17am 
Thank you for the clarification.

I know that I would have to use a text editor anyway to edit the playlist files and that this was already possible; the hurdle for me however is requesting the custom playlist that I’ve created already from the owner and then subsequently requesting that he reupload it to the server for usage in-game. I wasn’t really willing to do that as I did not see that it was worth the effort; instead I created one and saved it into the server directory where I can access it and edit it manually later.

I did glance at the structure of the playlist files; it doesn’t appear to be anything complicated but I am aware that if I do intend to construct a playlist via mass editing within the text editor, that—obviously—I would have to adhere to the original structure of the playlist (lest I encounter any errors as you have mentioned).
Grocel  [author] Jul 7 @ 11:44am 
I also agree that the playlist editor is not well designed for mass editing.
Grocel  [author] Jul 7 @ 11:43am 
Unfortunately the game file API does not allow reading or writing other files that ends with *.txt or *.dat, so you have to do the renaming trick.

Implementing an upload system or text editor system would be quite time consuming, because you would have to do the networking right and make it exploit proof. This is not worth effort in my opinion.

An option could be a simpler approach for mass editing playlist items in the editor via a text editor that is not raw editing and using a simplified format instead. This would be a full clientside solution that builds on top the existing networking.
Grocel  [author] Jul 7 @ 11:32am 
@Chris: The playlist editor was added to improve the usability of this addon when it comes to adding new songs/stream for beginners. A text editor would confuse them, because of the various formats the editor supports.

You can already use your favorite text editor for that. You can edit the playlist files in the data/streamradio/playlist folder (see description), without using the ingame editor. You would need file access to the server though. Either through FTP or other tools that allows file access to that folder. As the editor is Admin only (for a reasion), I don't think that would be an issue.

If you an experienced user and look at the files, you will understand how they work. Files that end with *_pls.txt and *_m3u.txt are valid renamed *.pls or *.m3u files. You could copy-paste in such files from your favorite music player and rename them.
Chris Jul 7 @ 10:44am 
You should implement a text editor within the playlist editor UI so playlist files can be edited conveniently instead of manually copying and pasting audio file URLs and appending titles for playlists that contain several tracks.

There should also be a ‘Select/Upload Playlist File’ option in the circumstance that an individual has created a playlist file already so it can immediately be uploaded. The same with a ‘Download Playlist File’ to retrieve a playlist from the server in circumstances that require such to occur.

Conveniently, there are softwares that can generate playlist files, and—with the usage of a text editor—Stream Radio playlists can immediately be edited by copying and pasting the playlist file content generated by the software between the file itself and the Stream Radio playlist editor UI, which saves plenty of time.
tehswordninja Jun 30 @ 10:48am 
Error 20: An illegal parameter was specified
Grocel  [author] Jun 28 @ 6:47am 
@TheShipMaster: I can not reproduce that problem and I have checked the files for being AddCSLuaFile'd. Are you sure that there aren't any addon conflicts or any other errors? Did you restart the game after downloading?

Please read this:

Please post your awnser there: