Files
WowRadio-Vanilla/README.md
T

147 lines
3.7 KiB
Markdown

# 📻 WowRadio — Vanilla
Listen to Internet Radio directly inside **World of Warcraft 1.12**.
WowRadio provides a simple in-game radio player with a large built-in station list, compact and full interface modes, custom stream support, saved settings and convenient playback controls.
## ✨ Features
- 100 built-in radio stations
- Game, Rock, Electronic, Jazz, Talk and Variety categories
- Compact and Full interface modes
- Previous / Next / Random station controls
- Custom radio stream support
- Automatic playback on login
- Saved settings and last selected station
- Key bindings
- Titan Panel integration
- Easy station management through `Stations.lua`
## 🖼️ Interface
### Compact mode
<img width="336" height="82" alt="WowRadio Compact Mode" src="https://github.com/user-attachments/assets/6a389409-854a-4c4c-a635-50be52a58229" />
### Full mode
<img width="506" height="389" alt="WowRadio Full Mode" src="https://github.com/user-attachments/assets/1f2b6410-5073-49f0-bff3-46109e278b61" />
## 📦 Installation
1. Download the addon.
2. Place the `WowRadio-Vanilla` folder inside:
`World of Warcraft\Interface\AddOns\`
3. Start or restart the game.
4. Make sure **in-game music is enabled**, as WowRadio uses the WoW music system for radio playback.
Open the options with:
`/wowradio`
or:
`/wr`
## 🎵 Commands
| Command | Description |
|---|---|
| `/wrtune <number>` | Switch to a station by number |
| `/wrplay` | Play the last selected radio station |
| `/wrstop` | Stop radio playback |
| `/wrnext` | Switch to the next station |
| `/wrprev` | Switch to the previous station |
| `/wrrnd` | Switch to a random station |
| `/wrlist` | Display the available station list |
| `/wrinfo` | Display the currently playing station |
| `/wrauto` | Toggle automatic playback on or off |
| `/wrcustom <url>` | Play a custom stream URL |
Example:
`/wrtune 10`
## 📡 Custom stations
Custom radio streams can be played directly with:
`/wrcustom http://example.com/stream`
Built-in stations are stored in `Stations.lua`.
Each station follows this format:
`{ "Stream URL", "Display Name", "CATEGORY" }`
Available categories:
- `GAME`
- `TALK`
- `ROCK`
- `ELECTRONIC`
- `JAZZ`
- `VARIETY`
Station numbering and synchronization are handled automatically.
## ⚙️ Compatibility
- World of Warcraft client 1.12
- Interface version 11200
- Ace2-based
- Titan Panel support
## 📜 Project identity & licensing
WowRadio-Vanilla is an independent community-maintained addon. It is not
affiliated with or endorsed by Blizzard Entertainment or by the radio stations
listed in `Stations.lua`.
The repository contains mixed-origin material. The historical WowRadio code has
no explicit project-wide license identified in the currently known upstream
repositories, so this fork does **not** claim to relicense that inherited code.
For details, see:
- [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)
- [PROJECT_IDENTITY.md](PROJECT_IDENTITY.md)
- [Docs/CODE_PROVENANCE.md](Docs/CODE_PROVENANCE.md)
- [Docs/ASSET_PROVENANCE.md](Docs/ASSET_PROVENANCE.md)
- [Docs/STATION_DIRECTORY_NOTICE.md](Docs/STATION_DIRECTORY_NOTICE.md)
- [LICENSES/](LICENSES/)
## 🙏 Credits
Original addon by **Tormentor @ Mannoroth** and **belthazor**.
Initial GUI and ideas by **jack.e**.
Vanilla version maintenance and additional improvements by **Dusk-92**.
## 📜 Changelog
### 1.1
- Updated radio stations
- Added Compact Mode
- Added mute button
- Added UI refinements
### 1.0
- Added 96 radio stations
- Added custom URL support
- Added fade-on-move option
- Added interface resizing
- Added saved settings
- Added key bindings
### 0.4a
- Backported to World of Warcraft Vanilla
### 0.4
- `/wrinfo` now correctly displays custom URLs
- Added Titan Panel plugin
- Moved station definitions to `Stations.lua`