Skip to content

Latest commit

 

History

History
114 lines (87 loc) · 9.32 KB

README.md

File metadata and controls

114 lines (87 loc) · 9.32 KB
Raw

Convergence-Jukebox-2

Update to the original Convergence Jukebox using a Kivy based GUI in place of Tkinter and now the working version. Convergence Jukebox 2 is a fully functional retro jukebox application. It emulates "physical" jukeboxes and is written in Python. The software has been designed to be fully functional, playing mp3's both randomly and via a credit system. More at www.convergencejukebox.com

Convergence Jukebox 2 is open source Python based software that has been written in Python 2.7 to emulate a “retro” style jukebox. The type of jukebox that was popular in bars, restaurants and recreation areas during the 1950’s and 60’s. Written from scratch by Brad Fortner of Convergence Communications, Convergence Jukebox 2 plays properly formed ID3 tagged mp3 media.

The Jukebox can be controlled for “personal” use by your computer keyboard but is better operated with a USB keypad. Its output resolution is modifiable allowing it to connect to inexpensive computer, laptop or TV displays with its “retro look and feel”. It can even be connected to bill, coin or card acceptors for “pay to play” situations. More information can including an FAQ and instructions on how to format mp3's be found on the Convergence Jukebox blog at www.convergencejukebox.com.

Features include;

  • Unlimited mp3 library size: Currently operating in our development centre is a version containing 15,800 mp3 files. This implementation runs on minimum hardware. In this case it’s an HP MINI 210 PC that contains an Atom N450 processor, 1024 MB of memory and a ‎160.0 GB hard drive. Jukebox 2.0 has yet to be tested on a Raspberry Pi.
  • Automatic Song Detection: MP3 library database is built automatically when additional properly formed ID3 tagged files are added to the media folder and the program is restarted.
  • Multiple Display Resolutions: Developers can change display resolution, skins and customize all items on the screen (such as song name positions) using Pythons Kivy code.
  • Customizable To Your Location: The Jukebox name or service at top of arch can be customized in the Python Kivy code.
  • Background Music System: Convergence Jukebox plays library loaded in Jukebox in a continuous manner randomly. Makes an excellent background music system.
    • Different Styles Of Music: mp3’s can be tagged with genres in comment area of ID3 tag. Random play can be set to play specific genres by altering a simple text file.
    • Songs Can Be Skipped: mp3’s can be tagged “norandom” meaning they will never play randomly. This means mp3’s with potentially unsuitable content can only be played if selected.
    • Avoids Repeating The Same Songs Continuously: mp3’s on the random list are only played once during a random play cycle.
    • Automatic Resetting Of Random List: Convergence Jukebox resets the random list when the software is rebooted or all selections in the jukebox have been played once randomly.
  • Clearly Identified Songs: While song is playing, song title and artist are displayed prominently under the Jukebox arch on the display.
    • More detailed song information is displayed in the green display (top left) that includes year released, song length and album name pulled from the mp3 id3 tags.
  • Convergence Jukebox plays user selected songs (paid) as a priority: When selected songs are listed in order of selection under the Upcoming Selections heading in the status area.
    • Users cannot select the same song if it’s on the Upcoming Selections list. This eliminates the same song from being played repeatedly.
    • Songs played via selection are removed from the random playlist. This eliminates the same song from being played repeatedly.
    • Random play resumes once user selected songs have completed playing.
  • Number of Credits, cost per credit and the number of songs available in the library are clearly displayed (and editable in the Python code) at the bottom left of the green screen .
  • Users can navigate through available music using up/down/left/right navigation keys.
  • Users can navigate through music selecting songs by either Title or Artist.
  • Users can navigate to the alphabetical start of either Artist or Title using specific letter keys that employ multiple keypresses.
  • A log is kept of each song played randomly, each song paid to play, when the Jukebox is rebooted, when songs are added and when a new random list is generated.
  • Python code has been written for is included in Convergence Jukebox that’s not been documented in the released version that talks to the Dropbox folder to providing RSS feeds for digital signage systems. As well as It is possible to include code to create tweets to Twitter accounts making the jukebox useful as a global barker system.

New In Convergence Jukebox 2.001;

  • Jukebox GUI re-written in Kivy.
  • Bug fix so last song on selection screen can now be accessed.
  • Artists are kept in proper alphabetical order including bands that start with The.
  • Bug fix so GUI wont crash when there are no titles or artists during Title Or Artist selection search.

The Convergence Jukebox website at www.convergencejukebox.com contains links to Python source code.

Version

0.001

Tech

Convergence Jukebox uses a number of open source projects to work properly:

Installation

  • Clone Convergence Jukebox 2 to a directory on your Windows computer.
  • Convergence Jukebox 2 requires Python 2.7 and the libraries (noted above) installed.
  • Convergence Jukebox 2 requires a music subdirectory with a minimum of 50 properly formed mp3 files.
  • Both convergenceplayer.py and convergencegui.py need to be running (launched in that order) for Convergence Jukebox 2 to operate.
  • Convergence Jukebox 2 as written here requires a 720p display in order for the GUI to line up correctly.
  • Toggling between Artist and Title sort is accomplished by hitting the forward slash "/" key. This differs from the original Convergence Jukebox imlementation.
  • Since Convergence Jukebox 2 is written upon the same code base as the original Convergence Jukebox, other than the change noted above one can find documentation for the rest of its features at http://bit.ly/2pSgoU7
  • Note Press escape key to exit Convergence Jukebox 2 GUI.

Music

Some versions of Convergence Jukebox are distributed with Creative Commons Music

Development

Want to contribute? Great! Fork the code.....

Todos

  • So much right now I don't even want to think about it.

License

GNU V3 General Public License