readme.txt

   1 A number of scripts that I am writing and using to work with CD/DVD
   2 writers, audio and video files, tv-tuners. Public domain.
   3
   4
   5 Subdirectories:
   6
   7    audio - scripts for manipulating ogg/mp3 files.
   8    cdr-dvdrw-tools - scripts for cdrtools and growisofs.
   9    video - scripts for manipulating video files.
  10
  11
  12 audio
  13 -----
  14
  15    Shell and python scripts for manipulating audio (ogg/mp3) files and tags.
  16
  17 setattrs.sh - set normal attributes (files rw-r--r--, directories
  18    rwxr-xr-x) after reading from a CD.
  19 find-nolist.py - find directories without a playlist.
  20 find-no3.py - find directories without mp3 files.
  21 find-nolist-no3.py - ... without both.
  22 mk_list.py - make a playlist for a directory.
  23 mk_list_recursive.py - make playlists in all subdirectories.
  24 mk_list_recursive.sh - make playlists in all subdirectories.
  25 fix-list-names.py - recursively rename all playlists to PlayList.m3u.
  26 recode_names.py - recode filenames from one encoding to another.
  27 recode-names-recursive.py - recode directories and filenames recursively.
  28 recode-id3v2.py - recode ID3 tags from one encoding to another.
  29 id3v1-to-v2.py - recode ID3 tags from version 1 to version 2.
  30 tag2name.py - get an ID3 tag and rename the file according to its tag.
  31 name2tag.py - make an ID3 tag according to the filename.
  32 recode-tags.sh - recode ID3 tags for listed files.
  33 recode-tags-list.sh - recode ID3 tags according to playlist and recode the
  34    very playlist.
  35 recode-tags-recursive.sh - recode ID3 tags playlists recursively.
  36 find-v1.py - find mp3 files with ID3v1 tags.
  37 find-v2.py - find mp3 files with ID3v2 tags.
  38 find-v1v2.py - find mp3 files with ID3v1 and ID3v2 tags.
  39 find-no-v1v2.py - find mp3 files without ID3 tags.
  40 playlist2name.py, playlist2name.sh - test (using the playlist) if the
  41    filename is in wrong case (copied from DOS partition) and fix the
  42    filename according to the playlist.
  43
  44
  45 cdr-dvdrw-tools
  46 ---------------
  47
  48    Here is a number of shell and python scripts to guide cdrtools and
  49 growisofs CD-R[W] and DVD-/+R[W] recording software - scripts for making
  50 (bootable) ISO images, burning and cloning disks, and testing the results.
  51
  52 .config - config file
  53 ls-iso, ls-image, ls-cdrom, ls-cdrw - list files in an ISO image, or on CD
  54    in the CD-ROM or CD-RW drive.
  55 get-iso, get-iso-cd, get-iso-cdrw, get-fs, get-cd, get-cdrw - get an ISO
  56    image or files from CD.
  57 test-disk, test-cdrom, test-cdrw - test the CD by copying its ISO image to
  58    /dev/null.
  59 mk-image - make an ISO image.
  60 mk-image.py - if there is just one source file (usually AVI) - strip
  61    extension to make the label.
  62 mk-image-boot - make bootable ISO image (El Torito).
  63 scan - scan the bus to find SCSI drives.
  64 cdrec-data, burn-test, burn, blank.sh, blank, blank-all, blank+burn,
  65    overburn-test, overburn, blank+overburn - burn a CD in all modes.
  66 clone-cd, clone-cdrw, clone-cd-rw, clone-cdrw-rw - clone a CD/DVD into a
  67    CD-R, CD-RW, DVD+RW; clone-cd recognizes options:
  68       -b - blank disk
  69       -d - burn DVD
  70       -l label
  71       -O - overburn
  72       -w - CD-RW
  73 diff-image, diff-cd, diff-cdrom, diff-cdrw - compare the CD with source
  74    directory.
  75 mp3-to-wavs - convert a list of mp3 files to wav files.
  76 burn-audio, blank+burn-audio - burn an audio disk.
  77 mk-audio - make an ISO image for an audio disk.
  78 mk-image-multi, burn-multi - burn multisession CD.
  79 burn+diff, blank+burn+diff, overburn+diff, blank+overburn+diff - burn and
  80    diff :)
  81 cdr-complete, cdrw-complete, cdr-800 - complete run: move file(s) into the
  82    source directory, normalize files and directories attributes, make an ISO
  83    image and list it, burn, diff and cleanup! Options:
  84       -l label - CD label; default is to ask
  85       -p prog - program to run; default is burn+diff
  86       -s - set normal attributes for files and directories.
  87 dvdrw, dvdrw-iso, blank-dvd, dvdr-complete, dvdrw-boot - scripts for
  88    burning DVD-/+R[W] disks.
  89
  90    All programs recognize the following environment variables (via .config):
  91
  92 CD_IMAGE_ISO=cd_image_iso
  93 CD_SOURCE_DIR=source_dir
  94 CD_WORK_DIR=work_dir
  95 CDR_SPEED=speed
  96
  97    Thus you may override parameters in .config.
  98
  99
 100 video
 101 -----
 102
 103 Using ffmpeg:
 104 ff_catvideo - concatenate few video files into one.
 105 ff_cropdetect - detect -vf crop parameters.
 106 ff_encode - 1 and 2-pass encoding using different codecs.
 107
 108 Using mplayer/mencoder:
 109 m_catvideo - concatenate few video files into one.
 110 m_cropdetect - detect -vf crop parameters.
 111 m_encode - 1, 2 and 3-pass encoding using different codecs.
 112 m_fix-avi-index - fix an AVI index.
 113 m_recode2mp3 - recode an audio stream to mp3, leaving video stream intact.
 114 m_split-avi - split an AVI file in two.
 115
 116 Using transcode:
 117 tc_calc_bitrate - estimate bitrate and audio volume scaling.
 118 tc_detectclipping - detect clipping.
 119 tc_encode - 1 and 2-pass encoding using different codecs;
 120    the input is supposed to be a file or a directory with ripped VOB files.
 121 tc_extract_a1 - extract an additional audio track and merge it into the output.
 122 tc_encode_x264 - 1, 2, 3-pass encoding using x264 binary;
 123    audio is converted to Ogg Vorbis; the resulting file is Matroska Video (.mkv).