search

Chordian / deepsid

The source codes for running DeepSID, a modern online SID player for the High Voltage and Compute's Gazette SID collections.
76 stars 6 forks source link
c64 commodore-64 commodore64 csdb hvsc sid websid

readme

DeepSID

These are the source codes for DeepSID, a modern online SID player for the High Voltage and Compute's Gazette SID collections. It can play music originally composed for the Commodore 64.

Setting up for offline use

You can use this in a local version on your own computer, if you want to. First, setup an environment that makes it possible to run PHP and MySQL. I personally use WampServer but there are a ton of options on the internet.

Folders and files

Download the GitHub tree above as well as the following files:

  1. Unpack the GitHub tree archive into a folder that works with your environment. I'll assume /deepsid/ root folder.
  2. If there are files in a /deepsid/images/ sub folder, delete them all.
  3. Create the /deepsid/fonts/ sub folder and unpack DeepSID_Fonts.zip into it.
  4. Create the /deepsid/images/ sub folder and unpack DeepSID_Images.zip into it.
  5. Create the /deepsid/images/brands/ sub folder and unpack DeepSID_Images_Brands.zip into it.
  6. Create the /deepsid/images/composers/ sub folder and unpack DeepSID_Images_Composers.zip into it.
  7. Create the /deepsid/images/countries/ sub folder and unpack DeepSID_Images_Countries.zip into it.
  8. Create the /deepsid/images/csdb/ sub folder and unpack DeepSID_Images_CSDb.zip into it.
  9. Create the /deepsid/images/players/ sub folder and unpack DeepSID_Images_Players.zip into it.

Download the following SID collections that will work with the database supplied below:

  1. Create the /deepsid/hvsc/ sub folder.
  2. Unpack the HVSC archive into the /deepsid/hvsc/ folder. This should create a /C64Music/ sub folder.
  3. Rename the /C64Music/ sub folder to /_High Voltage SID Collection/ instead.
  4. Unpack the CGSC archive into the /deepsid/hvsc/ folder. This should create a /CGSC/ sub folder.
  5. Rename the /CGSC/ sub folder to /_Compute's Gazette SID Collection/ instead.

Some collections are proprietary DeepSID collections. Download those here:

  1. Create the /_Exotic SID Tunes Collection/ sub folder inside the /deepsid/hvsc/ folder.
  2. Unpack DeepSID_Collection_Exotic_Tunes.zip into the new folder.
  3. Create the /_SID Happens/ sub folder inside the /deepsid/hvsc/ folder.
  4. Unpack DeepSID_Collection_SID_Happens.zip into the new folder.

Database

Download the following file:

This file contains all the MySQL database files that matches the HVSC and CGSC versions above. It also has one test user (user ID 1) with the password "test" for checking out a few basic ratings. There are no playlists.

  1. Create a database in your MySQL database, ready to receive tables.
  2. Unpack the archive and import all its SQL files into that database, one by one.
  3. Edit the /deepsid/php/setup.php file and change its constants to match your database.
  4. Remember to also change the ROOT_HVSC, HOST and COOKIE_HOST constants in the same file.

The user ID of 3 assigned to "USER_RATINGS" in setup.php is used for the letter folder quality filters. You can change this ID number to a user of your choice. The folder ratings of this user will then affect those quality filters. You have to give a letter folder two stars for the "Decent" option and three stars for the "Good" option.

You can run the /deepsid/logs/activity.htm file to see activity and also any errors. Note that it never logs ratings by other users (what they rate SID tunes is none of our business). If you want to see what tags were added, run the /deepsid/logs/tags.htm file.

If you have any problems getting the offline version to work please let me know and I'll try to help.