Programming Kulumi in 5 step

Download Scripts

1.Download the scripts

Add them to the main folder.And Double-Click the downloaded file to unzip it 

2.Connect the Devic

Connect your Kulumi X, Mini or Sheep to your laptop
with our proprietary data cable (green or red).

3.Delete unwanted files

Delete any unwanted files.
(Format Kulumi only when necessary and use the default format: FAT32)

4. Execute the Scripts

Place the script in the audio folder.
Double-click HTGv4.cmd to launch the programming interface.

5. Type Drive Letters & "Enter"

Type the drive letter. For multiple devices, separate letters with a space (e.g., d e f). Then, press “Enter”.

6. Monitor & Exit

A progress window will appear. Once the transfer is complete, the window will close. Type “5” and press “Enter” to exit the program.

FAQ

This warning is normal and appears because the HTG/Apple script is not digitally signed by a verified publisher. If you downloaded the script directly from HTG website or received it from a HTG representative, it is safe to proceed.

Simply click Run to continue with the programming process.

It depends on whether the order of your content matters.

  • Order doesn’t matter (e.g., songs, standalone stories): Yes, you can drag and drop these files directly into the drive. Since playback order isn’t important for this type of content, manual copying works fine.
  • Order matters (e.g., chapters, sequential episodes): Do not drag and drop these files. Copying and pasting directly does not preserve file order, so your content may play out of sequence. Instead, use the HTGv4 program to copy these files — it ensures they’re loaded in the correct order.

Quick rule of thumb: If the listening experience depends on files playing in a specific sequence, always use HTGv4. If not, drag and drop is fine.

If certain files aren’t playing, it’s usually due to one of two common issues:

  1. Folder structure isn’t set up in 3 levels
    The player expects files to be organized in a specific 3-level folder hierarchy. If your files are arranged outside this structure, the player may not recognize them. Double-check that your folders follow the required 3-level format before troubleshooting further.
  2. Files aren’t in MP3 format
    The player only supports MP3 files. If a file is in another format (e.g., WAV, M4A, mp4), it won’t play — even if it’s named or organized correctly. Check the file extension and convert it to MP3 if needed.

Use the same number of digits for every file name in a folder, based on the total number of files you have. This ensures your files sort in the correct numerical order rather than alphabetical order (which can jumble playback sequence).

Rules of thumb:

  • Up to 99 files: Use two digits (double digits).
    ✅ Correct: 01, 02, 03 ... 10 ... 99
    ❌ Wrong: 1, 2, 3 ... 10 (this will sort as 1, 10, 2, 3… instead of in order)
  • Up to 999 files: Use three digits (triple digits).
    ✅ Correct: 001, 002 ... 010 ... 100
    ❌ Wrong: 01, 02 ... 100 (breaks once you pass 99)
  • 1,000 files or more: Use four digits.
    ✅ Correct: 0001, 0002 ... 0010 ... 1000

Key rule: Always match the number of digits to the largest file count in that folder — and keep it consistent across every file in the same folder. Mixing digit lengths (e.g., 01 and 001 in the same folder) will cause files to sort out of order.

If the basics check out, the next step is to reformat the device and reload the content:

  1. Right-click on the drive in your file explorer.
  2. Select Format.
  3. Choose FAT32 as the file system (this is the default/required format).
  4. Once formatting is complete, reload your content using the HTGv4 run routine.

⚠️ Note: Formatting will erase all existing data on the device. Make sure you’ve backed up or saved copies of your files elsewhere before proceeding.

If the issue persists even after reformatting and reloading, contact us for further help.

If you see a notification like the above, it means your computer is not detecting the Kulumi player. Please contact [email protected]

A full stop (.) in the name of any main folder or sub-folder can prevent the player from reading the content correctly. As a result, no audio will play, even if all other folders are properly organized.

Please remove all full stops from folder names before loading content onto your Kulumi player.

Examples:

❌ Wrong:

  • Chapter 1. Intro
  • Story Time Vol.2
  • 01. Bedtime Stories

✅ Correct:

  • Chapter 1 Intro
  • Story Time Vol 2
  • 01 Bedtime Stories

Tip: If you’d like to visually separate words without using a period, try a space, hyphen (-), or underscore (_) instead.
✅ Story-Time-Vol2 or Story_Time_Vol2

 

This issue isn’t limited to folder names. If the MP3 file name itself contains a period or comma — anywhere other than the required .mp3 file extension — it will interrupt correct playback. Only the dot before the file type (.mp3) should be present; avoid any other periods or commas in the file name itself.

A long delay before playback is usually caused by too much silence at the beginning of the audio file (especially the first file in a folder).

Check the silence at the beginning and end of your audio files:

  • Leading silence (before the audio starts): Keep it between 0.5–1 second.
  • Trailing silence (after the audio ends): Keep it between 2–4 seconds.

You can easily adjust the silence using an audio editing tool such as Audacity (free audio editor).

Audacity — Free Audio Editor

After editing your files, reload the content using the HTGv4 programming routine and test the player again.

Yes, you can load audio content onto your Kulumi player, but you must ensure that you have the proper copyright permission to use and share it.

It is the user’s responsibility to obtain any required licenses or permissions from the content owner before distributing audio through Kulumi players.

The cables have different functions:

  • Green cable: Supports both data transfer and charging. Use this cable when programming your Kulumi player or transferring content.
  • Red cable: Supports data transfer only and does not charge the device.
  • Black cable (supplied): Supports charging only and cannot be used for programming or transferring content.

 

Yes. You can program multiple players simultaneously using your computer’s USB ports or a powered USB data hub.

Make sure the USB ports support data transfer (not charging only). USB Data Hub often has a blue inner tab, while charge-only ports may not support programming.

If you do not clear the existing content, the new files will be added underneath the existing content instead of replacing it.

This means:

  • Existing media files will remain on the player.
  • New media files will be added to the device.
  • The player may contain a mixture of old and new content.

To completely replace the content on your Kulumi player, clear the existing files before running the HTGv4 programming routine.

The MAC_Exclude file helps ensure that your audio content is organized and played in the correct order.

When audio files are processed on a Mac computer, hidden system files (such as .DS_Store files) may be automatically created. These hidden files can interfere with the player’s menu order and affect how content is displayed.

The MAC_Exclude program automatically detects and removes these unwanted files during the programming process. No additional action is required from the user.

Make sure the MAC_Exclude file remains at the first (main) level of the player drive when running the HTGv4 programming routine.