phantom-remote-control v1.2.2
Devialet phantom-remote-control
HTTP Adapter to remote control Devialet Phantom Speakers
This code allows you to control your devialet phantom using a very simple API, or even from your web browser. It automatically detects your Devialet Phantom speakers on your local network.
š” Features
Control the musical playback of your Devialet speakers
Devialet | š Phantom Dialog | š Phantom Premier | š Phantom Reactor |
---|---|---|---|
Play mp3 file | āļø | āļø | āļø |
Pause and Resume | āļø | āļø | āļø |
Stop | āļø | āļø | āļø |
Change volume | āļø | āļø | āļø |
Get current volume | āļø | āļø | āļø |
Increase or decrease volume | āļø | āļø | āļø |
Recover the playback position | āļø | āļø | āļø |
Recover the playback duration | āļø | āļø | āļø |
Move playback to a specific time of the music | āļø | āļø | āļø |
Control several speakers at the same time | āļø | ā | āļø |
š§ Installation
git clone https://github.com/VanVan/phantom-remote-control.git
cd phantom-remote-control
npm install
node index.js
ā¶ļø Usage
URL | Description |
---|---|
?play=http://site.com/music.mp3 | Play mp3 file |
?setVolume=30 | Set volume to a specific value |
?setVolume=Up | Increase volume |
?setVolume=Down | Decrease volume |
?pause=1 | Pause |
?play=1 | Resume |
?stop=1 | Stop |
?getPosition=1 | Get current position |
?getDuration=1 | Get music duration |
?seek=30 | Move playback to a specific time of the music |
š Example:
http://127.0.0.1:8090/?setVolume=Up
ā© These requests can be made by web browser or used as an API to serve as a keyboard shortcut for example.
š§° Configuration
No configuration is needed, it works out of the box, however, you can edit config.json if you need to.
{
"http_local_port": 8090,
"devialet_ipaddress": "autodetect",
"devialet_port": "autodetect",
"devialet_device_description_xml": "autodetect",
"ssdp_detection_interval": 10000,
"volume_step": 10,
"debug": false
}
Each variable in the config can have these options:
- http_local_port: Local port to use to listen HTTP request.
- devialet_ipaddress and devialet_port: Can be used together to force this program to use a specific or undetected sound system.
- devialet_device_description_xml: Can be used to force a specific device.
- ssdp_detection_interval: Interval to make SSDP request to find a device.
- volume_step: Up and Down volume step to use.
- debug: Let you use a .env file to specify environnement variable.
āØ Using this program as a service
If you use it every day with your speakers, it would be better to configure it as a service on a Linux server or on your personal computer. By doing it, the program will always be running.
Linux with systemd
You can simply install the service on Linux by entering the command
sudo node install_service.js
It will create a file /etc/systemd/system/devialet.service
You can then start the service by doing sudo systemctl start devialet
Windows
You can simply install the service on Windows by entering the command
node install_service.js
To check if it works, just open http://127.0.0.1:8090
on your browser
āļø Contributing
- Add new control features
- Add a control panel to use in the browser
š Copyright and license
Code released under the GNU General Public License v3.0.