Export Pro

Preparation

You must select the output format in the QuickTime Export Preferences pane:

In the Lite version, simply pick the iPod preset that you want. In the Pro version, First pick the encoder you want, then under that, pick the preset you want, or create a new one. You can edit the preset by pressing the "Edit…" button. kJams ships with several presets defined for each encoder, (or just one when only one really makes sense). You can pick the encoder and preset only once if you like, and never worry about it again, until you want to export a different format. The four buttons, "New…", "Duplicate", "Rename…", and "Delete" apply to the preset files. Your presets are stored in the kJams preferences folder (currently ~/Preferences/kJams/Export/).

Caveats

• You can't do anything other than 15 frames per second.
  
• You can't do multi-pass encoding.
  

I'll try to fix both these problems, but for now that's the way it is, even if you try to set these in the setting dialog, the settings will be ignored.

• iPod exporter is disabled: It just crashes, Apple is aware of the bug and will fix it. Until then, just use the "MPEG-4" encoder and pick an "iPod" preset that i've created. Apparently this will be fixed in the next major QuickTime update.
• 3G is disabled: it doesn't work on a background thread in 10.4. So i'm waiting for 10.5. I will write a "Helper App" that I can spawn to do things like this in a foreground thread, but I think 10.5 will already be out by then.
• AVI is disabled: output does not seem to produce audio, also seems related to 10.4. But then if you try to then import, first it won't import until you change the ".avi" extension to ".mov", but then when you try to play you'll get the "Can't move to background thread" error. These too will be fixed by the "Helper App" thingie, eventually.
• In the "QuickTime Movie" encoder, under "Audio" settings, DO NOT pick audio types that aren't already set as presets. eg: Only pick Linear PCM, AAC, or Apple Lossless. If you pick any others, kJams won't be able to play them. I hope to fix this soon, but until then, these are your only choices. However, if you're exporting for use in some other application (ie: you don't plan on re-importing them into kJams) then you can use any audio compression you want.
• Meta info is stored only in QuickTime (QT Meta Info, Unicode) files. If you export to any other, currently, no meta info is set.

Export

Select the song(s) you want to convert to QuickTime, then go:

File->Export->QuickTime...

If there are songs already currently exporting, the new songs will go to the same folder, else you will be asked to pick a folder for the destination.

Each song will then be exported using your chosen exporter.

You can then double click the resulting files to open in QuickTime Player.

Special Considerations

There is no limit to the number of songs you can export simultaneously, however your computer will probably start to get real slow if you're exporting a bunch at once. If this is an issue for you, let me know and I'll put in a pref to let the user specify the maximum number to export at once, that way you can cue up 100 songs for export, but only say 5 will actually export at a time (or however many you specify)

To get it onto your Video iPod

1. Go to Preferences->Export and (in Pro:) pick "MPEG-4" as the encoder, and (In Lite or Pro:) pick a preset that starts with "iPod".
2. Select the song(s) you want to export
3. File->Export->QuickTime
4. Select the resulting movie(s), right click and pick "Open With->iTunes"
5. Inside iTunes, locate and Get Info on the song(s)
6. In the "Info" tab, type in the Artist name, Album name, and whatever else you want
7. In the "Options" tab, in the "Video Kind" popup, choose "Music Video", press OK
8. Drag the video to your iPod