User guide

Play your own songs

DrumStrike plays community-created or your own song files: folders with a chart, audio and a song.ini. This guide explains what goes in a song folder, how to get it onto your iPad or iPhone, and how DrumStrike reads each file.

Quick start

  1. Download a community-created song, or use one you made yourself. Only download songs that are free to use, or songs you own the rights to. A download is usually a .zip or .rar containing one folder per song.
  2. Unzip it. DrumStrike reads folders, not archives.
  3. Copy the song folder into Files → On My iPad → DrumStrike (or On My iPhone).
  4. Open DrumStrike and tap Refresh (the circular arrow) in Song select.

Tip: Restarting the app isn't enough. DrumStrike keeps a cache of your library so it starts quickly, and only rescans your folders when you tap Refresh.

We do not support or endorse piracy. Community charts are made by fans, but the audio usually belongs to the artist and label. Only use songs and audio that you own or have permission to use, and don't use DrumStrike to play pirated music. Read more

Anatomy of a song folder

Each song lives in its own folder. A typical folder looks like this:

My Band - Great Song/
├── song.ini        ← title, artist, difficulty, preview… (required)
├── notes.mid       ← the chart (or notes.chart)
├── song.ogg        ← backing track / full mix
├── drums.ogg       ← optional instrument stems
├── bass.ogg
├── guitar.ogg
├── vocals.ogg
├── album.png       ← optional album art
└── video.mp4       ← optional background video
FileRequired?What it does
song.iniYesSong info. It must contain a [song] section. See song.ini.
notes.mid or notes.chartYesThe drum chart. If both are present, notes.mid is used. Other file names aren't read.
Audio (.ogg, .mp3 or .opus)At least oneThe music. Use a single song file or separate stems. See Audio & stems.
album.png / album.jpgNoAlbum art shown in Song select.
video.mp4NoA background video that plays behind the highway.

Folders can be nested as deep as you like, so you can organise your library any way you want:

DrumStrike/
└── My Songs/
    ├── Rock/
    │   ├── Band A - Song 1/
    │   └── Band A - Song 2/
    └── Practice packs/
        └── …

Folders whose name starts with a dot (.) are skipped.

Adding songs to your device

With the Files app (on the iPad or iPhone itself)

  1. Download and unzip the songs (only songs that are free to use, or that you own the rights to). The Files app can unzip: tap a .zip file to extract it.
  2. Long-press the song folder, choose Move (or Copy), then go to On My iPad → DrumStrike.
  3. In DrumStrike, tap Refresh in Song select. The status line shows "Rebuilding song library from disk…" while it scans.

With a Mac (Finder) or PC

  1. Connect your iPad or iPhone with a cable and select it in Finder (on Windows, use the Apple Devices app or iTunes).
  2. Open the Files tab and find DrumStrike.
  3. Drag your song folders onto DrumStrike.
  4. Tap Refresh in the app.

iCloud Drive: DrumStrike only scans its own folder on the device. Songs stored in iCloud Drive or another cloud folder have to be copied into On My iPad → DrumStrike first.

Folders DrumStrike creates

You'll also see a few folders that DrumStrike manages itself:

  • Songs/Practice and Samples: the free practice grooves and sample songs that come with the app.
  • Customs/Highway, Customs/Background and Customs/Video: your own visuals (see Custom highways & backgrounds).
  • Recordings and Export: your recordings and exported MP3s.

song.ini

The song.ini file describes the song. DrumStrike reads these keys from its [song] section. Others are ignored.

[song]
name = Great Song
artist = My Band
album = First Album
genre = Rock
year = 2024
charter = YourName
song_length = 215000
diff_drums = 4
diff_drums_real = 5
pro_drums = True
five_lane_drums = False
preview_start_time = 62000
preview_end_time = 92000
KeyMeaning
name, artist, album, genre, charterShown in Song select and used for search and sorting.
yearA plain number such as 2024.
song_lengthLength in milliseconds.
diff_drums / diff_drums_realDifficulty rating, shown as stars and used for "Sort by difficulty". diff_drums_real is used for pro drums songs.
pro_drumsTrue if the chart has pro drums (cymbal/tom) information.
five_lane_drumsTrue for 5-lane drum charts.
preview_start_time / preview_end_timeThe section (in ms) played as a preview when you select the song. Without preview_start_time there's no preview.
video_start_timeDelays the background video by this many ms.
practiceTrue puts the song in the Practice list.

Good to know: DrumStrike recognises a song by the contents of its song.ini. If you edit that file, the song counts as new, and its high scores, favorite status and playlist entries no longer apply. Two folders with identical song.ini files are treated as the same song.

The delay key isn't used. To shift notes against the audio, use Delay notes in Settings (see Sync & latency).

notes.mid (MIDI charts)

DrumStrike reads the track named PART DRUMS. Each difficulty uses its own range of MIDI notes:

DifficultyKickRedYellowBlueGreen5-lane green
Expert96979899100101
Hard848586878889
Medium727374757677
Easy606162636465

Cymbals and toms (pro drums)

In MIDI charts, yellow, blue and green notes are cymbals by default (hi-hat, ride and crash). Tom markers turn them into toms:

Marker noteEffect
110Yellow becomes the high tom
111Blue becomes the mid tom
112Green becomes the floor tom

A marker can be held over a long stretch of notes. This follows the standard pro drums conventions used by community charts.

5-lane charts

A MIDI chart that uses the 5-lane green note (101, 89, 77 or 65) is converted to 4-lane pro drums:

  • Red → snare
  • Yellow → hi-hat
  • Blue → blue tom
  • Orange → crash
  • Green → floor tom

Sections, lyrics and disco flip

  • Sections: [section Verse_1] text events become song sections. You can jump to or loop them from the Sections panel, where they appear as "Verse 1".
  • Lyrics: lyrics from PART VOCALS can be shown under the drum notation.
  • Disco flip: the mix 3 drums0d / mix 3 drums0 events swap snare and hi-hat.
  • Flams: two adjacent drums hit at the same moment are shown as a flam. You can turn this off with the Use flams setting.

notes.chart (text charts)

.chart files are text-based charts, made with community chart editors. DrumStrike reads the [Song], [SyncTrack], [Events] and [ExpertDrums] sections.

Note: For .chart songs, DrumStrike currently uses the Expert drum chart whichever difficulty you pick. Use a notes.mid version of the song if you want separate Easy, Medium and Hard charts.

Note numberMeaning
0Kick
1Red (snare)
2 / 3 / 4Yellow / blue / green (toms by default)
55-lane green, played as the floor tom
66 / 67 / 68Cymbal markers: yellow / blue / green become hi-hat / ride / crash

This is the opposite of MIDI charts: in .chart files notes are toms unless a cymbal marker is present. The MusicStream entry in [Song], if present, picks the main audio file.

Audio & stems

DrumStrike looks for these audio files in the song folder, in .ogg, .mp3 or .opus format:

File nameContents
songFull mix or backing track
drums, drums_1 … drums_4Drums (all drum stems are switched together)
bassBass
guitarGuitar
vocalsVocals
keysKeys
crowdCrowd noise (switched off by default)

Multitrack songs

When a song has at least two separate instrument stems (for example drums.ogg and guitar.ogg), DrumStrike treats it as a multitrack song:

  • It gets the Multitrack badge.
  • It appears under the MULTITRACK filter.
  • You can switch drums, bass, guitar, vocals, keys and crowd on and off while you play. Mute the drums to play the part yourself.

In Settings → Tracks switched on at start you choose which instruments are on when a song begins.

A song with only song.ogg (or song.ogg + drums.ogg) plays as a single mix.

Not supported: .mogg (multitrack/encrypted audio), .wav, .flac and .m4a stems. Convert them to .ogg or .mp3 first.

Album art & video

  • Album art: name the image album.png or album.jpg. It's shown on the song details panel. On iPhone the small images in the list are hidden to save space.
  • Background video: name it exactly video.mp4. Use video_start_time in song.ini to delay it. A song's own video takes priority over your custom backgrounds.

General MIDI & MP3 songs

Not everything needs a song.ini and a chart:

  • General MIDI drum files. Put .mid or .midi files in a folder without a song.ini. Each file becomes a song: the title is the file name and the artist is the folder name.
    • DrumStrike reads the drums on MIDI channel 10.
    • If an .mp3 with the same name sits next to it, that's used as the music. Otherwise DrumStrike plays its own drum sounds.
  • MP3 play-along. Any .mp3 in a folder without a song.ini appears as a song (title and artist come from its tags). There are no notes, but you can use the player, loops and speed control to practise along.

These songs use the full drum mapping (kick, snare, hi-hat, open hi-hat, three toms, ride and crash). Difficulty levels don't apply.

Lanes & colours

DrumStrike plays everything on a 4-lane pro drums highway with separate cymbal and tom notes:

LaneTom / drumCymbal
KickBass drum (bar across the highway)–
RedSnare–
YellowHigh tomHi-hat (closed and open)
BlueMid tomRide
GreenFloor tomCrash
  • Detect open hi-hats (on by default) turns a ride note among closed hi-hats into an orange open hi-hat note. This fixes older charts.
  • Flip Blue / Green Cymbals swaps the ride and crash lanes if your kit is set up the other way round.

Sync & latency

SettingUse it when…
Input latency (0–200 ms)Your hits are judged too late. Measure it in the setup wizard or Settings by playing along with a click. DrumStrike also suggests a new value when your hits stay early or late for a few songs.
Delay notes (−1000 to +1000 ms)The notes and the music are out of sync with each other, for example in a chart with an offset. Positive values make the notes arrive later.
Hit windowYou want stricter or more forgiving timing: Strict (150 ms), Normal (210 ms), Relaxed (270 ms, default) or Custom (80–400 ms). Turn on Show hit zone on highway to see it.

Tip: Bluetooth headphones add a lot of audio delay. Wired headphones or the kit's own headphone output give the tightest timing.

Custom highways & backgrounds

Put your own files in these folders, then choose them in Settings → Display with the visual picker:

  • Customs/Highway: highway textures (.png / .jpg).
  • Customs/Background: background images.
  • Customs/Video: looping background videos (.mp4, played silently). A video takes priority over a background image.

Not supported (yet)

  • Archives: .zip, .rar, .7z and .sng. Unzip first. .sng files can't be used.
  • Audio: .mogg, plus .wav / .flac / .m4a stems.
  • 2x kick / Expert+ notes (MIDI note 95, chart note 32).
  • Star power / overdrive and drum fill (activation) lanes.
  • Accents and ghost notes, solo, roll and trill markers.
  • Extra drum tracks such as PART DRUMS_2X or PART REAL_DRUMS_PS.
  • The delay key in song.ini and Offset in .chart files (use Delay notes instead).
  • Hi-hat pedal position (MIDI CC). Only note messages from your kit are used.

Missing something you need? Ask on Discord.

Troubleshooting

My song doesn't show up

  • Did you tap Refresh after copying?
  • Is the folder inside On My iPad → DrumStrike, and not still zipped?
  • Does song.ini exist, and does it start with a [song] line?
  • Is there at least one .ogg, .mp3 or .opus file?
  • Is it a duplicate? If another folder has an identical song.ini, only one of them is shown.

The song loads but has no notes

  • The chart must be named notes.mid or notes.chart.
  • In a MIDI file, the drum track must be called PART DRUMS.
  • In a .chart file, there must be an [ExpertDrums] section.

"One or more audio files could not be loaded"

An audio file is missing, damaged or in an unsupported format. Check the file names and formats in Audio & stems. You can still choose Play anyway to play with the files that did load.

Notes are out of sync

If every song feels late, measure your Input latency. If only one song is off, adjust Delay notes. See Sync & latency.

Cymbals show up as toms (or the other way round)

That's the chart. MIDI charts without tom markers show cymbals, and .chart files without cymbal markers show toms. Look for a pro drums version of the chart.