Media Player - opencardev/crankshaft GitHub Wiki

Crankshaft has a built-in media player with support for common audio formats.

What is supported

The following audio formats are currently playable from USB storage and CSSTORAGE:

  • mp3
  • flac
  • aac
  • mp4
  • mp4a
  • wma

Since Alpha2 you can also listen to mp3 streams (see below).

How to add your media for playback?

Media files from an external USB storage device or CSSTORAGE, in a folder named Music, will be loaded into the Crankshaft Media Player when Crankshaft boots up.

Note that the Music folder should be in the root of the drive. The name is case sensitive. Subfolders inside the Music folder are detected as album folders containing media files. Files that are not in subfolders will not be detected.

External USB storage can be used hot plug. On connect new media is scanned and on remove it is cleaned up from the player. For CSSTORAGE this is not the case.

Streaming radio

  • Strm files can be used to allow the player using streaming media for example internet radio.
  • The strm file must contain an absolute stream url like http://my.streaming.com/stream.mp3 and nothing more.
  • The name of the strm file is used inside the player (My Stream.strm is shown as entry My Stream)
  • You can add a custom cover for strm files placing a PNG file with same name on same folder (My Stream.strm -> My Stream.png)

Since Alpha5 media player is reworked to use covers for album selection. During boot a cache of cover images is created from 1st mp3 file inside of an album folder if no folder.png or folder.jpg is available.