Tools for DAM Karaoke Song data
This software is developed for technical research on DAM Karaoke machines.
The Karaoke song data normally recorded on DAM Karaoke machines is protected by copyright. You must handle it in accordance with your local laws and regulations.
In this video, a song not normally included in DAM Karaoke machines, "This is an Attack," is played and scored on that machine.
This software reads and writes DAM Karaoke machines compatible karaOKe Data (OKD) file.
Dump chunks of a OKD
$ dam-song-tools dump-okd --help
NAME
dam-song-tools dump-okd - Dump chunks of a OKD
SYNOPSIS
dam-song-tools dump-okd OKD_PATH OUTPUT_DIR_PATH
DESCRIPTION
Dump OKD
POSITIONAL ARGUMENTS
OKD_PATH
Input OKD path
OUTPUT_DIR_PATH
Output directory path
NOTES
You can also use flags syntax for POSITIONAL ARGUMENTS
Pack a OKD by directly inputting a required data in each chunk
$ dam-song-tools pack-okd --help
NAME
dam-song-tools pack-okd - Pack a OKD by directly inputting a required data in each chunk
SYNOPSIS
dam-song-tools pack-okd OKD_PATH <flags> [CHUNK_PATHS]...
DESCRIPTION
Pack OKD
POSITIONAL ARGUMENTS
OKD_PATH
Output OKD path
CHUNK_PATHS
Input chunk paths
FLAGS
-s, --scramble=SCRAMBLE
Default: False
Scramble. Defaults to False.
NOTES
You can also use flags syntax for POSITIONAL ARGUMENTS
Convert a OKD to a Standard MIDI File
$ dam-song-tools okd-to-midi --help
NAME
dam-song-tools okd-to-midi - Convert a OKD to a Standard MIDI File
SYNOPSIS
dam-song-tools okd-to-midi OKD_PATH MIDI_PATH <flags>
DESCRIPTION
Convert a OKD to a Standard MIDI File
POSITIONAL ARGUMENTS
OKD_PATH
Input OKD path
MIDI_PATH
Output MIDI path
FLAGS
-s, --sysex_to_text=SYSEX_TO_TEXT
Default: True
Convert SysEx Messages to Text Meta Messages
NOTES
You can also use flags syntax for POSITIONAL ARGUMENTS
Convert a Standard MIDI File to a OKD
$ dam-song-tools midi-to-okd --help
NAME
dam-song-tools midi-to-okd - Convert a Standard MIDI File to a OKD
SYNOPSIS
dam-song-tools midi-to-okd MIDI_PATH PLAYING_OKD_PATH P3_OKD_PATH <flags>
DESCRIPTION
Convert a Standard MIDI File to a OKD
POSITIONAL ARGUMENTS
MIDI_PATH
Type: str
Input MIDI file path
PLAYING_OKD_PATH
Type: str
Output Playing OKD path
P3_OKD_PATH
Type: str
Output P3 OKD path
FLAGS
-s, --scramble=SCRAMBLE
Default: False
Scramble. Defaults to False.
NOTES
You can also use flags syntax for POSITIONAL ARGUMENTS
- Port 0, Track 0-15: Instrument
- Port 1, Track 0-7,9-15: Instrument
- Port 1, Track 8: Guide melody
- Port 15, Track 0: M-Track
P(laying)-Track is performance data of a song.
M(arking)-Track includes list of hook section, two-chorus fadeout position and others. The note map in MIDI for compose is as follows.
- Hook section: C3
- Two-chorus fadeout position: C5 (Note on alone is sufficient)
Please check the test data.
- DAM-XG5000[G,R] (LIVE DAM [(GOLD EDITION|RED TUNE)])
- DAM-XG7000[Ⅱ] (LIVE DAM STADIUM [STAGE])
- DAM-XG8000[R] (LIVE DAM Ai[R])
- soltia48
- Nurupo - Author of the MIDI file "This is an Attack" from which the test data was derived
Copyright (c) 2024-2025 soltia48