de It'sGotTheVibez - last.fm Scrobbler for the Trekstor Vibez

It'sGotTheVibez - a Scrobbler for the Trekstor Vibez

It'sGotTheVibez is a last.fm offline-scrobbler for Trekstor's Vibez portable music player, which means it feeds your last.fm profile with music you listened to on the go.

If you arrived here, you probably already know last.fm and what it's for. Otherwise you can educate yourself below on this page. :-)

Note: RioVolution.org provides an extremely helpful discussion forum for the Trekstor Vibez where you can find lots of tips and best practices and where you'll get quick answers to your questions from fellow Vibez owners and developers!

Getting Started

For any questions, suggestions or just for chatting with fellow Vibez owners, simply join the It'sGotTheVibez user group at last.fm. :-)

Please note: It'sGotTheVibez currently is a pure command line application, however it would probably relatively easy to extend it with a GUI, if someone wants to take on this task. Besides that It'sGotTheVibez provides its functionality using modules which can also be used easily by other applications.

A GUI is planned for version 0.3, however there's no estimated release date so far.

Prerequisites

  • a Trekstor Vibez ;)
  • a last.fm account (obviously)
  • Either Microsoft Windows (2000, XP, Vista) OR a system supported by Python 2.4 / Python 2.5 (eg. Linux, also Windows, ...)

Download It'sGotTheVibez

It'sGotTheVibez, an offline-scrobbler for the Trekstor Vibez portable music player
It'sGotTheVibez for Windows (Vista, XP, NT, 2000)
itsgotthevibez_0.2-alpha3_win32.zip (2.3MB)
It'sGotTheVibez for other systems (Linux, MacOS X, Unix, etc.; requires separate Python 2.4 or 2.5 installation)
itsgotthevibez_0.2-alpha3.tar.bz2 (0.03MB)
It'sGotTheVibez, an offline-scrobbler for the Trekstor Vibez portable music player
default package (Linux, MacOS X, Unix, Windows, etc.; requires separate Python 2.4 or 2.5 installation)
itsgotthevibez_0.1.2.tar.bz2 (0.02MB)

Usage

Usage of It'sGotTheVibez for updating your last.fm listening profile is pretty simple. If your Vibez is attached to your computer and mounted, the following suffices for a full sychronization of your Vibez' DB with It'sGotTheVibez (and thus, with last.fm).

It'sGotTheVibez 0.2.x and a Vibez with firmware 1.15 or later: (Strongly recommended! The music.log file can be enabled on the Vibez running firmware 1.15 or later in MENU -> Settings -> Advanced -> Listening Log.)

./itsgotthevibez.py -u USERNAME -p PASSWORD -f <VIBEZ-MOUNTPOINT>/music.log

It'sGotTheVibez 0.1.x:

./itsgotthevibez.py -u USERNAME -p PASSWORD -z <VIBEZ-MOUNTPOINT>/.private/smalldb

It'sGotTheVibez 0.2.x and a Vibez with the original firmware version 1.04:

./itsgotthevibez.py -u USERNAME -p PASSWORD -m privatedb -z <VIBEZ-MOUNTPOINT>/.private/smalldb

Supplying your user name and password as command line arguments is not recommended however, for obvious secrity reasons. It'sGotTheVibez also supports a simple configuration file to which you can add all required information, and which allows you to call It'sGotTheVibez without a single command line argument at all. Updating your profile could not be simpler.

Futher usage details and an example configuration file can be found in the It'sGotTheVibez downloadable tar ball.

If you encounter any problems, have questions or want to suggest new features, just join the It'sGotTheVibez user group at last.fm!

Limitations / Restrictions

Please Note: If you use It'sGotTheVibez 0.1.x or the privatedb import module of It'sGotTheVibez 0.2.x, your Vibez must be switched off before it's connected to your computer, otherwise its database cannot be parsed. If you accidentially left you Vibez turned on before connecting it and It'sGotTheVibez complains loudly, just unmount your Vibez, unplug it, turn it off and attach it to your computer again. It'sGotTheVibez can not damage anything on your Vibez, as it accesses the database in read only mode exclusively. You can also mount your Vibez completely read-only for extra safety, if you like.

It'sGotTheVibez is a pure command line application, however it would probably relatively easy to extend it with a GUI, if someone wants to take on this task. Besides that It'sGotTheVibez provides its functionality using modules which can also easily be used by other applications.

Unfortunately, It'sGotTheVibez does not yet work with Microsoft's IronPython implementation for the .NET plattform, as some modules which It'sGotTheVibez needs for communication with the Audioscrobbler system are missing from IronPython 1.0. However, IronPython 1.1 will include these modules and I plan to ensure It'sGotTheVibez' compatibility with IronPython 1.1 for .NET.

In the meantime, you can try Markus Gerhold's VibezScrobbler, which is written in Java, based on It'sGotTheVibez' Vibez DB parser and the Karmascrobbler and also works on Windows.

Normally, you should see a collage of my favourite music albums' cover art. Unfortunately, your browser is not able to display this collage. :-(

You need to enable JavaScript and a FlashPlayer plugin to view it.

Now, what IS last.fm, after all?

last.fm is a huge and pretty cool music community site which automatically computes personalized music recommendations for each user, based on his or her listening profile. Additionally crosslinks between the artist's information pages available at last.fm are created depending on similarities between the artists deduced from the users listening habits. This way, you can find lots of interesting artists previously unknown to you just by browsing the last.fm site, starting at the information page of an artist you like,

last.fm is powered by a system called Audioscrobbler which is fed with the required data by its users, who submit information about the music they are listening to - this process is called scobbling. last.fm users scrobble tracks they listen to using special software music players or plugins for their preferred software player - these programs are simply called Scrobblers.

It'sGotTheVibez - a Scrobbler for the Trekstor Vibez

If you're a last.fm user and also own a portable music player, be it a pure MP3 player or a more versatile device, you probably have a problem. So far, there's not a single portable player I know if which officially supports the audioscrobbler system. In effect this means that you lose any information about the music you listen to on the go, at least from the point of view of your last.fm listening profile. However, there are a few inofficial Scrobblers for some selected portable music players, written by last.fm enthusiasts.

It'sGotTheVibez is a scrobbler for Trekstor's Vibez portable music player. Using It'sGotTheVibez you can scrobble all tracks you listened to while on the go, ie. It'sGotTheVibez feeds your last.fm profile with music you listened to on your Vibez.

The program is the result of several relaxing hours with my family around christmas 2006 - sitting inmidst about a dozend paper sheets covered with hex dumps which I used to reverse-engineer the Vibez' binary data base format to a level which enabled me to extract all required data for writing a working scrobbler... ;) (And, no, in my optinion analyzing binary data base formats is no worse way to spend your leisure time than solving sudoku or crossword puzzles. After all, with a solved sudoku puzzle you still cannot feed your last.fm profile, can you? ;)

How does the privatedb import module work? (for the technically interested)

Up to firmware version 1.15, the Vibez unfortunately keeps no track listen log which would be required for accurate scrobbling. It does save quite a few information about its music collection in an internal data base, however it's also lacking some information which would be required to implement a perfectly working scrobbler. The Vibez stores some static meta data like the artist, title, album, length etc. of each track, as well as a play counter (a natural number) and a "last playing time" timestamp. It does not, however, explicitely record all times a track is played. Thus It'sGotTheVibez remembers the last known playing counter and the last known listening time of each track and compares this information with the data provided by the Vibez during the next sync. With this information, the last listen event of each track can be submitted verbatim to last.fm, previous listening times have to be extrapolated using a more or less intelligent algorithm. The more often you sync your Vibez, the more accurate the submitted data will be.

The Trekstor Vibez is closely related to the Rio Karma mp3 player, which is supported by the Karmascrobbler. However, Karmascrobbler and It'sGotTheVibez have been developed completely independently.

Valid XHTML 1.0 StrictValid CSS!
-- /software/itsgotthevibez_en.php#20080421-002921  [0] © Gunter Ohrner 2007-2013. Powered by CubbiCMS