Project

walkon

0.0
No release in over 3 years
Low commit activity in last 3 years
Play your entrance music
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.3
>= 0
>= 0
>= 0
 Project Readme

Walkon

Walkon plays your entrance music. It's a daemon process that periodically checks hcitool scan for new Bluetooth devices, then uses their ESSIDs to find tracks to play as they enter the network.

Status: Alpha

This is definitely not ready for prime-time use. Don't complain to me if it breaks.

Installation

Walkon requires the following components to have already been installed:

  • Ubuntu (for best results, but any Linux that supports BlueZ will do)
  • Ruby 2.x or above
  • BlueZ, the official Linux Bluetooth protocol stack
  • XMMS, a command-line audio player for Linux

Install the gem from RubyGems:

$ gem install walkon

You must also connect speakers to your machine's soundcard output in order to actually hear tracks...

Usage

Place an MP3 in /music that corresponds with your device's ESSID. So, if your device's name is "iPhone5", you would upload a track like so (from your own machine):

$ scp your-track.mp3 walkon:/music/iPhone5.mp3

Then, run the daemon process to sniff for that ESS ID and play the track when it first becomes available (on the host machine):

$ walkon

To find out more about how it works, read the Documentation.

Contributing

  1. Fork this project
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Commit your tests (git commit -am "I'm a good boy because I test my code")
  5. Push to the branch (git push origin my-new-feature) and create Pull Request.