Permalink
Branch: master
Find file Copy path
d29d748 Sep 30, 2018
2 contributors

Users who have contributed to this file

@moodeaudio @jotak
executable file 245 lines (212 sloc) 7.52 KB
########################################################
#
# Setup Guide for moOde audio player
#
# These instructions are designed to initially configure
# moOde audio player. Additional help is provided within
# the player via the (i) information buttons.
#
# Updated: 2018-09-27
#
# (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 all commands with sudo
- AP mode IP address: 172.24.1.1, SSID: Moode, pwd: moodeaudio, channel: 6
- AP mode starts automatically when wlan0 SSID is 'blank' in Network config and there is no Ethernet connection, or WiFi SSID is defined but no IP address is assigned
- Default Samba shares are NAS, RADIO, SDCARD, USB
- Each USB disk will also have a Samba share named after its Disk Label
WIFI ADAPTERS THAT SUPPORT ACCESS POINT MODE
- Raspberry Pi 3 integrated WiFi adapter
- Canakit WiFi Adapter
- Raspberry Pi USB WiFi Dongle
- WiFi adapters based on RTL RT5370 chipset
- Edimax EW-7811Un
IN-PLACE SOFTWARE UPDATES
- Updates to moOde software are made available periodically and can be downloaded and
installed from within moOde itself 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, I2S audio device: None
b) MPD options: EDIT SETTINGS
c) Leave Volume control set to "Software"
d) Set Audio device to "USB audio device" then APPLY
- I2S DEVICE
a) Menu, Configure, Audio
b) Select an I2S audio device then SET
c) Reboot
d) Menu, Configure, Audio, MPD options: EDIT SETTINGS
e) Leave Volume control set to "Software"
f) Verify Audio device is set to "I2S audio device" then APPLY
3. TIME ZONE AND AUDIO DEVICE DESCRIPTION
a) Menu, Configure, System
b) Select appropriate timezone then SET
c) Menu, Customize
d) Scroll down to Audio device description and select a device. The entry is for display on the
Audio info screen. If a particular device is not listed then select "USB audio device". Note
that I2S devices are automatically populated.
4. ADD SOURCE(S) CONTAINING MUSIC FILES
- USB STORAGE DEVICES
a) Inserting or removing a USB storage device automatically initiates MPD database update
b) Wait for completion (no spinner on the Music tab)
c) Browse panel. Click the refresh button to update the folder list.
d) To manually update or regenerate the MPD database follow the steps below
- SDCARD STORAGE DEVICES
a) Menu, Configure, Sources
b) UPDATE or RE-GEN MPD database
c) Wait for completion (no spinner on the Music tab)
d) Browse panel. Click the refresh button to update the folder list.
- NAS DEVICE
a) Menu, Configure, Sources
b) CREATE NAS source (MPD database update initiates automatically after SAVE)
c) Wait for completion (no spinner on the Music tab)
d) Browse panel. Click the refresh button to update the folder list.
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, Restart, 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, Restart, Reboot
2. CHANGE HOST AND SERVICE NAMES
a) Menu, Configure, System (and Audio)
b) SET after entering appropriate value in each name field
c) Reboot is required if changing Host name and/or Browser title
3. AUTO-CONFIGURE AT BOOT
NOTE: This works only on a fresh image that has never been booted!
NOTE: To start AP mode at boot set wlanssid to blank e.g., wlanssid=
a) Change values in the file below
b) Paste contents into /boot/moodecfg.txt
c) sudo reboot
d) Join AP SSID if using AP mode, then http://hostname.local (or http://172.24.1.1)
##########################################
# Copy this file to /boot/moodecfg.txt
# worker will process it at startup then
# delete it and automatically reboot.
#
# All param=value pairs must be present.
# Set wlanssid=<nothing> to start AP mode.
# Example: wlanssid=
##########################################
[names]
hostname=moode
browsertitle=moOde Player
airplayname=Moode Airplay
spotifyname=Moode Spotify
bluetoothname=Moode Bluetooth
squeezelitename=Moode
upnpname=Moode UPNP
dlnaname=Moode DLNA
mpdzeroconf=Moode MPD
[services]
airplaysvc=0
upnpsvc=0
dlnasvc=0
[network]
wlanssid=MySSID
wlansec=wpa
wlanpwd=MyPassword
wlancountry=US
apdssid=Moode
apdchan=6
apdpwd=moodeaudio
[other]
timezone=America/Detroit
themecolor=Emerald
////////////////////////////////////////////////////////
//
// 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, Restart, Shutdown
c) Install I2S audio device
d) Power on
e) Menu, Configure, Audio
f) Select appropriate I2S audio device then SET
g) Menu, Restart, Reboot
h) Menu, Configure, Audio, MPD options: EDIT SETTINGS
i) Verify Audio device set to "I2S audio device"
j) APPLY
2. Switching from I2S to USB audio device
a) Menu, Configure, Audio
b) Select "None" for I2S audio device then SET
c) Menu, Restart, Shutdown
d) Optionally unplug I2S audio device
e) Plug in USB audio device
f) Power on
g) Menu, Configure, Audio, MPD options: EDIT SETTINGS
h) Select "USB audio device" for Audio device
i) APPLY
3. Switching from WiFi back to Ethernet
a) Plug in Ethernet cable
b) Menu, Configure, Network
c) RESET network configuration to defaults
d) Menu, Restart, Shutdown
e) Remove WiFi adapter
f) Power on
////////////////////////////////////////////////////////
//
// END
//
////////////////////////////////////////////////////////