Skip to content

Latest commit

 

History

History
102 lines (55 loc) · 3.22 KB

install.rst

File metadata and controls

102 lines (55 loc) · 3.22 KB

Hardware requirements

  • a computer running an operating system hosting MPD, LIRC and Bash - that is usually some flavour of UNIX/Linux

  • an infrared receiver connected to that computer

    • via GPIO: in my case it's an IR detector (e.g. Vishay TSOP31238, less than 1,- €)
    • or via USB (not in this description here, but probably working the same way)

  • an IR remote control - supported by LIRC

  • and optionally a printer

Software requirements

  • mpd configured and running

  • mpc standard CLI client for sending commands to mpd

  • lircd running and configured (more details in the LIRC section below):

    * /etc/lirc/lirc_options.conf    driver and device configuration.
* /etc/lirc/lircd.conf           main config file. Just includes further *.conf files
* /etc/lirc/lircd.conf.d/*.conf  defined remote control(s)
                                 (downloaded from http://lirc.sourceforge.net/remotes/
                                 or recorded with irrecord -l)
* ~/.lircrc                      user's command assignments

  • several standard Linux tools (grep, awk, sed, sort, tr, cut, ...)

  • optional (for Text To Speech): espeak

  • optional (for printing): Cups (with lp), Ghostscript (with gs and ps2pdf), paps

Note

Optional patch for paps

The original paps package (creating Postscript for printing) in version 0.6.8-6 doesn't have a --title option for filling the header on the printed document with own text.

It shows the filename - or the string "stdin" - instead.

Since I really wanted to be able to place variable text in the header I created a patch for that. It's described at https://www.ziemski.net/paps

But of course rcmpd is working with the unpatched paps as well - just without the individual header.

Installation

  1. Save rcmpd into a directory available via $PATH (e.g. in ~/bin).

  2. Make it executable, e.g. with chmod u+x rcmpd

  3. execute rcmpd --checkinstall to do a base installation check

  4. `Install-and-configure-LIRC-for-your-RC`_ (see below)

  5. in file rcmpd itself

    • in function define_remotes() adapt the keys of your remote control(s) you want to use
    • in function help_keys() adapt the help text describing the keys
    • in function button_menu() optionally adapt to your needs (and key names...)

  6. Create an appropriate ~/.lircrc file for handling the RC commands

    It needs to match your RC (name and buttons) and the commands in rcmpd.
    It's possible to create it manually, but it's easier to use

    rcmpd --createlircrc

  7. (Re)start irexec to let it know about the new ~/.lircrc: rcmpd --restartirexec

  8. Test it in your shell by rcmpd <command> with <command> being any of the defined commands above.


If all works fine you should make irexec autostart.

That may be done via an entry in /etc/rc.local like this:

su - pi -c "/usr/bin/irexec --daemon /home/pi/.lircrc"

Or if playback should start immediately:

su - pi -c "/usr/bin/irexec --daemon /home/pi/.lircrc ; mpc play"

You should use a "normal" user (here: pi) for that.