m3u2tkc bash script tool for the Zaurus and tkcPlayer

This is a command-line tool which builds play lists for the commercial application tkcPlayer. The software runs on the Sharp Zaurus devices. I wrote this as an exercise in bash scripting, but it is useful too. Feel free to email me with comments/bugs, but I cannot guarantee a reply. - Ian G.

As of version 1.10 this has two search modes. One looks for all MP3 and OGG files, and the other reads M3U files (which was the original purpose, hence the name). Either can be used with the filtering and tagging options.

The options usage is a bit non-standard but it is not ambiguous. Options without parameters are of the form
--option
whereas options with parameters are always the short form, such as -d directory

Here is a bunch of example usage. I inserted some dashed lines in between my commands, but they are in sequence and should be helpful. Here is a screen shot (86K). You can see what tkcPlayer looks like after some of these examples.

I have tested this recently on:

  • SL-C860 running tkcPlayer-c7xx 2.0-031101, using the Cacko QTopia ROM 1.21
  • SL-5600 running tkcPlayer-2.0-031101, using Sharp ROM 1.32
  • SL-6000 running tkcPlayer-c7xx 2.0-031101, using Sharp ROM 1.12 (retail)
NOTE: Read the comments in the file header please.

[DOWNLOAD IT]
then,
chmod +x ./m3u2tkc.sh
so that you can run it, or run it using
/bin/bash ./m3u2tkc.sh

bash-2.05$ ./m3u2tkc.sh --help

 m3u2tkc version 1.10

 Builds tkcPlayer play lists.
 Ian Giblin, giblin@panix.com, July 2003

 Usage: m3u2tkc.sh [options] -d dir

 -d dir   specifies input folder
 -f text  filters input list names
 -t tag   prepends tag to listnames

 Note: -d  must be the last argument.

 --help     displays this help
 --list     lists all playlists
 --clean    DELETES all playlists
 --restore  replaces config with bkp
 --use_M3U  looks for M3U files

 The config file is backed up the first
 time you run this script.

 Examples:

   ./m3u2tkc.sh -d /mnt/card
   ./m3u2tkc.sh --use_M3U -d /mnt/card
   ./m3u2tkc.sh -f Beastie -d /mnt/cf/
   ./m3u2tkc.sh --clean

 Link: http://www.panix.com/~giblin/

bash-2.05$

Back to top level