Permalink
######################################################## | |
# | |
# Setup Guide for moOde audio player | |
# | |
# These instructions are designed for initial configuration | |
# of moOde audio player. Additional configuration help is | |
# provided within the player via the (i) information buttons. | |
# | |
# Updated: 2020-11-15 | |
# | |
# (C) Tim Curtis 2017 http://moodeaudio.org | |
# | |
######################################################### | |
//////////////////////////////////////////////////////// | |
// | |
// GENERAL INFORMATION | |
// | |
//////////////////////////////////////////////////////// | |
NOTE: Use http://moode, moode.local or IP address, whichever works on your network. | |
Typically Android OS will only work with IP address. | |
- SSH login user: pi, pwd: moodeaudio | |
- Preface commands requiring root permission with sudo | |
- Access Point (AP) mode: | |
(a) IP address: 172.24.1.1 | |
(b) SSID: Moode | |
(c) Password: moodeaudio | |
(d) Channel: 6 | |
- AP mode starts automatically when: | |
(a) WiFi SSID is set to 'None' in Network config and there is no Ethernet connection | |
(b) WiFi SSID is defined but no IP address was assigned by DHCP. This typically | |
occurs when connection to the SSID fails. | |
- Default Samba shares are NAS, Playlists, Radio, and SDCard | |
- Each USB disk will also have a Samba share named after its Disk Label | |
WIFI ADAPTERS THAT ARE REPORTED TO SUPPORT AP MODE | |
- Raspberry Pi 3, 4 and Zero W integrated WiFi adapters | |
- Comfast CF-912AC dual-band WiFi adapter | |
- For all other adapters consult the manufacturer | |
IN-PLACE SOFTWARE UPDATES | |
- Updates to moOde software are made available periodically and can be downloaded | |
and installed from by clicking "CHECK for software update" in System Config | |
- Click VIEW to see a list of what is contained in the update package | |
- Click INSTALL to download and install the update package | |
IMAGE WRITING UTILITIES | |
https://www.raspberrypi.org/documentation/installation/installing-images/ | |
//////////////////////////////////////////////////////// | |
// | |
// PLAYER SETUP AND CONFIGURATON | |
// | |
//////////////////////////////////////////////////////// | |
1. INITIAL SETUP | |
a) Insert boot SD card or USB drive | |
b) Connect USB or I2S audio device | |
c) Connect USB storage devices | |
- Ethernet mode | |
a) Insert ethernet cable | |
b) Power on | |
c) http://moode | |
- Access Point (AP) mode | |
a) Insert WiFi adapter that supports AP mode | |
b) Power on | |
c) Join network SSID=Moode, pwd=moodeaudio | |
d) http://moode.local or http://172.24.1.1 | |
2. AUDIO DEVICE SETUP | |
- USB DEVICE | |
a) Menu, Configure, Audio | |
b) Select "None" for I2S audio device then SET | |
c) Restart | |
d) Menu, Configure, Audio | |
e) EDIT MPD config | |
f) Leave Volume control set to "Software" | |
g) Set Audio output to the name of the USB audio device | |
h) SAVE | |
i) Restart | |
- I2S DEVICE | |
a) Menu, Configure, Audio | |
b) Select an I2S audio device then SET | |
c) Restart | |
d) Menu, Configure, Audio | |
e) EDIT MPD config | |
f) Leave Volume control set to "Software" | |
g) Verify Audio output is set to the name of the I2S audio device | |
h) SAVE | |
3. TIME ZONE | |
a) Menu, Configure, System | |
b) Select appropriate timezone then SET | |
4. ADD SOURCE(S) CONTAINING MUSIC FILES | |
- USB STORAGE DEVICES | |
a) Insert USB storage device | |
b) Menu, Update library | |
c) Wait for completion (no spinner) | |
- SDCARD STORAGE DEVICES | |
a) Menu, Update library | |
b) Wait for completion (no spinner) | |
- NAS DEVICE | |
a) Menu, Configure, Library | |
b) CREATE Music source | |
c) After SAVE, return to Playback or Library | |
d) Menu, Update library | |
e) Wait for completion (no spinner) | |
- MUSIC DATABASE UTILITIES | |
a) Menu, Configure, Library | |
b) Various utilities will be listed in the Music Library section | |
5. VERIFY AUDIO PLAYBACK | |
- Ethernet mode | |
a) http://moode | |
b) Play one of the radio stations | |
- AP mode | |
a) http://moode.local | |
b) Browse, SDCARD, Stereo Test | |
c) Menu for "LR Channel And Phase" track | |
d) Play | |
At this point a FULLY OPERATIONAL PLAYER exists. | |
//////////////////////////////////////////////////////// | |
// | |
// CUSTOM CONFIGS | |
// | |
// Customize the player by using any of the following | |
// procedures. | |
// | |
//////////////////////////////////////////////////////// | |
1. CONFIGURE FOR WIFI CONNECTION | |
- Ethernet mode | |
a) Leave eth cable connected | |
b) Insert wifi adapter (while Pi running) | |
c) http://moode | |
d) Menu, Configure, Network | |
e) Configure a wifi connection | |
f) Menu, Power, Shutdown | |
g) Unplug eth cable | |
h) Power on | |
- Access Point (AP) mode | |
a) Join network SSID=Moode, pwd=moodeaudio | |
b) http://moode.local | |
c) Menu, Configure, Network | |
d) Configure a wifi connection | |
e) Menu, Power, Restart | |
2. CHANGE HOST AND SERVICE NAMES | |
a) Menu, Configure, System (and Audio) | |
b) SET after entering appropriate value in each name field | |
c) Restart is required if changing Host name | |
3. AUTO-CONFIGURE AT BOOT | |
NOTE: This works only on a fresh image that has never been booted! | |
a) Mount the SDCard which will make the boot partition accessible | |
b) Copy the file /boot/moodecfg.ini.default to your PC, Mac or Linux client | |
c) Rename it to moodecfg.ini | |
d) Edit the settings as needed | |
e) Copy moodecfg.ini to /boot/ | |
f) Insert SD Card in Pi and power up | |
g) Join AP SSID if using AP mode, then http://hostname.local or http://172.24.1.1 | |
//////////////////////////////////////////////////////// | |
// | |
// AFTER PLAYER SETUP | |
// | |
// Follow these instructions for making certain types | |
// of changes | |
// | |
//////////////////////////////////////////////////////// | |
1. Switching from USB to I2S audio device | |
a) Unplug USB audio device | |
b) Menu, Power, Shutdown | |
c) Install I2S audio device | |
d) Power on | |
e) Menu, Configure, Audio | |
f) Select appropriate I2S audio device then SET | |
g) Menu, Power, Restart | |
h) Menu, Configure, Audio, EDIT MPD config | |
i) Verify Audio output is set to "I2S audio device" | |
j) SAVE | |
2. Switching from I2S to USB audio device | |
a) Menu, Configure, Audio | |
b) Select "None" for I2S audio device then SET | |
c) Menu, Power, Shutdown | |
d) Optionally unplug I2S audio device | |
e) Plug in USB audio device | |
f) Power on | |
g) Menu, Configure, Audio, EDIT MPD config | |
h) Set Device type to "USB audio device" | |
i) SAVE | |
j) Menu, Power, Restart | |
3. Switching from WiFi back to Ethernet | |
a) Plug in Ethernet cable | |
b) Menu, Configure, Network | |
c) RESET network configuration to defaults | |
d) Menu, Power, Shutdown | |
e) Remove WiFi adapter | |
f) Power on | |
//////////////////////////////////////////////////////// | |
// | |
// Command API | |
// | |
// Below are a list of commands that can be submitted to | |
// moOde via http or ssh | |
// | |
//////////////////////////////////////////////////////// | |
1. Base URL is http://moode/command/?cmd= | |
2. MPD commands that are listed in MPC help | |
3. Volume commands that are listed in /var/www/vol.sh --help | |
4. Library update via the command libupd-submit | |
HTTP examples: | |
// MPD | |
http://moode/command/?cmd=stop | |
http://moode/command/?cmd=play | |
// Volume | |
http://moode/command/?cmd=vol.sh up 2 | |
http://moode/command/?cmd=vol.sh mute | |
// Library update | |
http://moode/command/?cmd=libupd-submit.php | |
SSH examples: | |
// MPD | |
mpc stop | |
mpc play | |
// Volume | |
/var/www/vol.sh up 2 | |
/var/www/vol.sh mute | |
// Library update | |
sudo /var/www/libupd-submit.php | |
//////////////////////////////////////////////////////// | |
// | |
// END | |
// | |
//////////////////////////////////////////////////////// |