nextsong.log File Format

  1. API Reference
    1. API Types
    2. Class Types
    3. JSON API
    4. XML API
    5. Session API
    6. JSON and XML APIs - Asynchronous API Responses
    7. Server Class Method Reference {#apiserverclass}
    8. System Class Method Reference {#apisystemclass}
  2. System Accounts
  3. Advanced Configurations
    1. Dual v3/v2 Deployment
    2. Using centovacast.conf
  4. Command-line Tools
    1. Controlling Centova Cast
    2. Diagnostic Report Generator
    3. Fixing Problems
    4. Centova Cast Management Utility
      1. Management Utility Invocation
      2. Output Formats
    5. Reinstalling Centova Cast
    6. Uninstalling Centova Cast
    7. Update Utility
  5. Customizations
    1. Init Script
    2. Menu Customizations
    3. Wrapping Server Applications
  6. Event Scripts
    1. Event Script Reference
    2. Event Notification Scripts
    3. Event Script Structure
  7. Files and Paths
    1. Account Files and Paths
    2. Core Files and Paths
    3. Formats
      1. nextsong.log File Format
  8. Plugins
    1. Event Script Reference
    2. Example Plugin
    3. Plugins API
    4. Plugin Structure

nextsong.log File Format

The nextsong.log file, under the /usr/local/centovacast/var/vhosts/USERNAME/var/log directory, is a diagnostic log created by the Centova Cast autoDJ interface to record information about the songs it instructed the autoDJ to play.

Formally the log file is just freeform text and may not adhere to any specific format (particularly when debugging is enabled). However, lines that begin with a date and time followed by a ">" character are playback records.

Playback Records

In playback records, everything after the ">" character is a CSV-formatted line with the following columns:

  • duration - indicates how long it took for Centova Cast to identify the next track to be played
  • source - indicates from where Centova Cast obtained the next track information (usually "database" to indicate the autoDJ database; may also be "static" indicating that the autoDJ database was unreachable and a local static playlist was used; "fallback" indicating that a static playlist was not available and fallbackfile.mp3 was served; or "error" indicating that fallbackfile.mp3 was unavailable and the master station_unavailable.mp3 was served)
  • pathname - the full pathname to the song that was played
  • formatted - the formatted metadata for the song that was played
  • artist - the artist name for the song that was played
  • title - the title for the song that was played
  • royaltyid - the royalty ID for the song that was played
  • timelimit - the time limit that was imposed
  • playlistid - the ID number of the playlist from which the track was selected
  • playlist - the name of the playlist from which the track was selected
  • message - the diagnostic message generated while handling this track (usually OK -- anything else indicates an error condition occurred)

Any one of these fields may be empty except duration and message.

Previous: Formats
Section: Formats
Next: Plugins