Skip to content
Snippets Groups Projects
Lemni's avatar
Lemni authored
0-2-2

Closes #26

See merge request !5
6465811e
History

** SONIC UNIVERSE **

Side A - Sonic Scout Driver version 0.2.0-alpha

What is that ?

The Sonic Scout Driver is a tool to explore the Sonic Universe, where artists become stars, album become continents and a track playing becomes a landscape hiking. The main purpose is to display a different visualization of the music universe, and hopefully get an easier navigation. The system allows to play the selected continents (if the vlc python module is installed and the track is present on the user's file system), to annotate it and to keep track of the journey.

Install

Requirements:

  • Python 3
  • VLC (the real VLC program with same architecture (32/64 bits) than Python)

The following items are python3 packages, that can be installed via pip (syntax pip3 install ..., make sure pip is up to date)

Highly advised:

  • python-vlc

And if you want a graphical interface, add one of the following pip packages:

  • wxPython, based on WX. Most advanced frontend but rusty and has some trouble depending on the OS
  • PyQt5 (5.14.1 here), based on Qt. Recently migrated frontend, not stable yet, improvements ongoing

(A binary is accessible.)

Quick launch

Go in the corescoutdriver directory and run python3 LaunchSSD.py, which will ask some questions in shell about visual and names.

Once in the program, you will first need to fill the universe by giving a local directory containing music files via the Fill/Fill universe command (wx, qt: "Universe" menu ; sh: choice [UNIVE] of the main menu)

Then you can navigate through the tracks via the buttons (qt/wx) or [SCOUT] menu (sh).

More infos

Troubleshooting

In shell, especially in the tutorial, some lines wait until the user presses Enter, so in doubt press it (theorically the system will warn you).

Quick commands

General

  • h for help
  • i for informations on current element

Visual

  • z,q,s,d (wx/qt) to move
  • scroll or +/- to zoom (Notice that the autopilot will only pick items in the visual field)

Navigate

  • click on object in the visual (wx/qt) triggers the play of the object (if star or planet)
  • >? to go to the next random track
  • *< & >* to navigate through the music history
  • ># to reach a specific track based on its name (or artist by prefixing the search by star:)
  • a to add a track to current playing list (opens track search dialog)

Handled formats

The system can read:

  • .mp3
  • .flac
  • .mp4 (audio only and internal navigation bug from VLC)

Other

Any help would be appreciated (direct feedback or even participation to code) Bug report will soon be open, currently the system is too partial and unstable to make this kind of feedback valuable.

For tutorials and advanced information, see the Wiki

Side B - Sonic Archive Fundation

cf https://saf.aws.afola.ovh/