eseq Archives - Alex's Piano Service

Creating PIANODIR.FIL for ESEQ Files

Yamaha’s earlier floppy disks use the propriety ESEQ format. They also use a primitive form of copy protection, where the first sectors of the disks are missing. This means computers identify the disks as corrupt, requiring you to use specialized software to back up your Disklavier disks. In place of these sectors, Yamaha uses the PIANODIR.FIL file, which serves both as a file table and a song index.

Converting MIDI files to ESEQ

If you want to use MIDI files with your older Disklavier, you can, but you have to convert them to ESEQ first. There’s software to do this conversion. You can either get it from http://www.carolrpt.com/MIDItools.htm or you can download the whole DKVUTILS suite from my MEGA drive.

Once you download DKVUTILS.ZIP from my site or theirs, you’ll need to extract it. The program that converts MIDI files to ESEQ files is MID2ESEQ.EXE. This program runs only on Windows, and does not seem to run with emulators. Reach out to me and I can assist with conversion.

Using MID2ESEQ, just drag and drop MIDI files into the window.

If you have a Yamaha that’s capable of playing ESEQ only, you might also need to create a PIANODIR.FIL index. Continue scrolling down for instructions!

Creating a PIANODIR.FIL using ESEQ Explorer

If you are creating a floppy disk for use with an earlier ESEQ only Disklavier, or if you’re preparing ESEQ files for transfer to a Nalbantov USB stick, you might have to create your own PIANODIR.FIL.

Note: Please note that the filenames should be strictly eight characters long, have no spaces, and be entirely uppercase, including the FIL extension BEFORE following the process below. If you don’t do this, some pianos will be unable to read the files. I’ve created a program to conveniently rename all your .fil files at once, which is especially helpful if you have numerous albums.

You’ll need the DKVUTILS suite downloaded. You can download DKVUTILS from my MEGA drive or from http://www.carolrpt.com/MIDItools.htm.

First, put all the ESEQ files you’ve created in a folder together. The DKVUTILS suite includes a program called ESEQ Explorer. Once you open the program, select the directory you’ve stored your ESEQ files in (make sure they’re properly renamed according to the above instructions, or use my program to rename them for you). You’ll see a screen like the one below:

Note that, if you don’t currently have a PIANODIR.FIL, there will be a red X in front of it. That means it’s not present. Right-click on it and select Create Index. The contents of that folder are now ready to be added to a disk using the Nalbantov tools. If your file names are too long, you’ll see them renamed with ~ symbols. In my experience, this is a program, and indicates they likely won’t read in the piano. Make sure to rename them appropriately first.

I’ve also quoted the text file from the DKVUTILS.ZIP tool below, since they’re informative:

Yamaha Disklavier discs are always on Double Density (2DD) media, High Density (HD)discs, which are more common nowadays, will not work. Furthermore, they are formatted to 720 Kbytes not the default of 1.2 Mbytes. The original discs are copy protected. This has been achieved by placing invalid data on the first sector. As DOS and Windows always refer to this sector to check out a floppy, they will report that the discs are bad. The Yamaha machinery ignores the first sector, so it reads them normally.

The music files on a Disklavier disc have the extension .FIL. They are frequently identified with titles like PIANO001.FIL, but sometimes they have names similar to DOS like MUSIC1.FIL. In addition to the music files, there is an index file on the disc. This contains a list of the active music files on the disc, their titles, and pointers to their position on the disc. The index file is always called PIANODIR.FIL and always has a size of 6 Kbytes. In order to set up a Disklavier disc to function on a Disklavier, you must first copy the music files onto it in Disklavier format (ESEQ) and then run the ESEQ EXPLORER program to build the index file.

Disklavier Floppy Disk Backups, ESEQ and MIDI Formats

Some of my customers choose to upgrade their older Disklavier’s floppy drive to a Nalbantov USB drive, and want to know how to copy songs from their old Disklavier floppy disks onto a USB. Some of them just want to be able to back up their disks in case they need to make new ones later. Or maybe, you’re just trying to figure out how to write to disks your Disklavier can actually read!

This post is intended to help you read from, write to, or replace Yamaha Disklavier floppy disks.

If you want your floppy disks files saved on a more modern media, you can also mail your floppy disks to me (please reach out to me at [email protected] or through my Contact page). Nalbantov also has a disk transfer service, and they can be very useful if you encounter particularly challenging disks. Make sure to use the AlexPiano for a 5% discount on orders from Nalbantov.

If you’re adding new music to a floppy disk or Nalbantov USB and have an older Disklavier (such as the popular MX100II), you’ll need to make sure the files are in Yamaha’s proprietary ESEQ format. Using the tools below, you can convert your MIDI files to ESEQ so that they will be in your Disklavier’s native language.

Obtaining Files from your Yamaha Disks

Yamaha floppy disks are a great source of songs that you know will be formatted correctly for your piano. However, floppy disks often don’t age well, and are very susceptible to sunlight and magnetic fields. (This is one more reason to back them up!)

Disklavier floppy disks cannot be natively read by your computer, which makes them difficult to back up. They use a very primitive form of copy protection.

There are several tools that will allow you to read them: I use the Player Piano Floppy Backup Utility 1.4, created by Mark Fontana. It’s freeware, but he requests donations. You can download it from him, or you can download ppfbu_v1.4_setup.exe from my MEGA drive. It can read and save directly in ESEQ format, even if the disk it’s reading from is in MIDI. It appears to run acceptably on Mac / Linux using emulators.

There are other tools out there. Most notably, there was a Hack-a-Day project by Tom Nardi that uses a Python script to copy the data off the floppies. His disklav.py tool is available on GitHub.

If you copied the files in ESEQ format, there’s an extra step before your Disklavier can read them. See below!

The Player Piano Floppy Backup Utility v1.4 running on my dedicated Windows XP “floppy copy” box.

Obtaining even More ESEQ Files from the Internet

In addition to the originals you might have, you can sometimes find these on eBay or at local music stores. Older disks on eBay are seldom tested, so there’s some risk of receiving junk disks.

There are several large online repositories in both ESEQ and MIDI formats. Some of these are of dubious legality. One legitimate resource is http://www.kuhmann.com/Yamaha.htm, which is also quite a large repository. I have a copy of their entire database on my MEGA drive. (I worry a lot about these older resources disappearing!)

You can also source files from Yamaha’s website, although this a more expensive option. Many of their MIDI files have multiple instruments (or even limited piano), and are more designed for their keyboards and other MIDI devices. However, they do have an entire category of Piano Solos, and these are what you’ll want to search for when selecting files. When you download these, you get their associated MIDI files, which are comfortably sized for floppy disk purposes.

Converting MIDI files to ESEQ

If you want to use MIDI files with your older Disklavier, you can, but you have to convert them to ESEQ first. There’s software to do this conversion. You can either get it from http://www.carolrpt.com/MIDItools.htm or you can download the whole DKVUTILS suite from my MEGA drive.

Once you download DKVUTILS.ZIP from my site or theirs, you’ll need to extract it. The program that converts MIDI files to ESEQ files is MID2ESEQ.EXE. This program runs only on Windows, and does not seem to run with emulators. Reach out to me and I can assist with conversion.

Using MID2ESEQ, just drag and drop MIDI files into the window.

MIDI files that have only one track are called Type 0 files. MIDI files with multiple parts are Type 1. Occasionally, the piano will be spread between two tracks. In that case, you’ll find the piano is playing only half or so of the notes it should be. You can convert Type 1 to Type 0 files using the tool gn1to0.exe that’s also stored on my MEGA drive. This is a slightly cumbersome tool, but will either run on Windows or on Linux/Mac using Wine.

Using conversion software to merge all the MIDI tracks.

ESEQ Files and creating your PIANODIR.FIL

If you have a Yamaha that’s capable of playing ESEQ only, you might also need to create a PIANODIR.FIL index. I have instructions here on creating a PIANODIR.FIL index.

If you are using a Nalbantov, any USB stick you use MUST be formatted either FAT16 or FAT32.

Please also note that the ESEQ filenames should be strictly eight characters long, have no spaces, and be entirely uppercase, including the FIL extension BEFORE creating the PIANODIR.FIL file. I’ve created a script to automate this proper naming process, discussed in my creating a PIANODIR.FIL index instructions.

Potential ESEQ Problems

If you’re using a USB stick in a Nalbantov, it must be formatted FAT16 or FAT32. Nalbantov supplies a video on how to format your USB stick.

If you’re using an actual floppy disk, it must be a 2DD disk formatted to 720 KB.

Earlier Disklaviers can be finicky about their ESEQ files. Sometimes, they’ll work without any trouble, even without a PIANODIR.FIL file. However, particularly in earlier Disklaviers (such as the DK5R), you’ll need to be more careful with the naming conventions, and you’ll definitely need that PIANODIR.FIL described above.

I’m very grateful for the research of Mike Isreal (in the comments below), who did experimentation with his own Disklavier. Before creating a PIANODIR.FIL for your disk, make certain that all filenames are precisely eight characters long, and that both the filename and extension are in all-caps. The filename must contain no spaces.

Some have commented that it appears you can also omit the .FIL extension (at least in some cases). According to Nalbantov, there might be cases where a fully lower-case filename and extension are called for, although I have not run into that particular case yet.

Some of this is caused by the choosiness of the Disklavier itself, but it seems likely to me that a lot of the free tools we’re relying on probably add their own complications. If you are experiencing any trouble, please reach out to me for assistance. You can also Categories Disklaviers Tags , , , 11 Comments