# Volumio Control for Raycast

URL: https://www.raycast.com/riclib/volumio-control

> Control your Volumio music player: play, pause, skip, shuffle, see what's playing, and browse playlists, albums and songs.

- Install: raycast://extensions/riclib/volumio-control
- Author: [Ricardo Liberato](https://www.raycast.com/riclib)
- Installs: 84
- Categories: Media
- Updated: 2026-11-17
- Source: https://github.com/raycast/extensions/tree/886cbd73fe377ad1d8f0c17083e6cd4c96748a33/extensions/volumio-control/

## Commands

- **Play/Pause**: Toggle playback
- **Play**: Start playback
- **Pause**: Pause playback
- **Next Track**: Skip to next track
- **Previous Track**: Skip to previous track
- **Stop**: Stop playback
- **Toggle Shuffle**: Toggle shuffle mode
- **Now Playing**: View current playing track and controls
- **Media Controls**: Full media control panel
- **Browse Music**: Browse and play playlists, albums, and songs

## README

### Volumio Control for Raycast

Control your Volumio music player directly from Raycast.

#### Features

##### Individual Media Commands
- **Play/Pause** - Toggle playback with a single command
- **Play** - Start playback
- **Pause** - Pause playback
- **Next Track** - Skip to the next track
- **Previous Track** - Go back to the previous track
- **Stop** - Stop playback completely
- **Toggle Shuffle** - Turn shuffle mode on/off

##### Full Control Views
- **Now Playing** - See what's currently playing with album art and full controls
- **Media Controls** - Complete media control panel with all playback options
- **Browse Music** - Browse and play your music library

#### Installation

1. Make sure you have Raycast installed
2. Clone this repository
3. Run `npm install` to install dependencies
4. Run `npm run build` to build the extension
5. Run `npm run dev` to run in development mode
6. Or import the extension to Raycast using the Import Extension command

#### Configuration

In Raycast preferences for this extension:
- **Volumio Host**: Set your Volumio hostname or IP address (defaults to `volumio.local`)

#### Usage

##### Quick Commands (no-view)
These commands execute immediately without opening a window:
- `Play/Pause` - Toggle playback
- `Play` - Start playing
- `Pause` - Pause playback
- `Next Track` - Skip forward
- `Previous Track` - Skip backward
- `Stop` - Stop playback
- `Toggle Shuffle` - Switch shuffle on/off

##### View Commands
These commands open a window with more options:
- `Now Playing` - See current track with album art and controls
- `Media Controls` - Full control panel with volume, shuffle, repeat
- `Browse Music` - Navigate your music library and play content


#### Requirements

- Volumio instance running on your network
- Network access to your Volumio instance
- Volumio API must be accessible (usually on port 80)

#### Troubleshooting

If you can't connect to Volumio:
1. Verify your Volumio instance is running
2. Check the hostname/IP in extension preferences
3. Ensure you can access Volumio web interface at `http://[your-volumio-host]`
4. Check your network connection
