Howto for using K-Yamo

This is by far no good manual, it is just a quickstartguide. If somebody feels like writing a good manual, he is really welcome. At the moment I prefer to develop further. If you have questions about the usage, that are not clear enough by this manual, feel free to contact me. If you find the app horrible to handle for some circumstances, also feel free to email me. I will do my best to get this little proggy as usefull as I can.

• What is K-Yamo ?

  • K-Yamo is a musictagger, that supports mp3 and ogg at the moment.
    • It writes ID3v1, ID3v2.3 and ID3v2.4-Tags in mp3s
    • ID3v1 and ID3v2.3 can be used together
    • Also ID3v1 and ID3v2.4 can be used together
    • It can attach pictures to mp3files
    • It can tag as much files or directories at once you want it to
    • It uses a filter for cleaning up selected files into a structured directorytree
  • It is also a cdripper for ripping audio-cds with cdparanoia and ecoding with lame
    (maybe other encoders to follow)
    • Ripper fetches taginformation from freedb
    • Ripper also writes ID3v1, ID3v2.3 and ID3v2.4-tags
    • Attaching of pictures is also supported in Ripper
    • The same filter as in Tagger is used to integrate the new ripped files into the directorystructure

• K-Yamo is splitted up into parts

  • The Settingsdialog
  • The Taggerdialog
  • The Ripperdialog

The Settings

• CD-Ripper-Settings

  • You can choose between four encoding-engines. (lame,gogo,bladeenc,oggenc)
  • If you don't have the executables in standard loactions you can select the right file with Find Executable .
  • You can select the desired bitrate for the encodingengine with the radiobuttons. (Bladeenc does not support VBR, so it is deactivated)
  • You can add some commandlineoptions specific for the selected encodingengine in the textfield Commandlineoptions .

• Database-Settings

  • You can select the databaseengine, you want to use. (Till now only MySQL is ready)
  • With the autocompletecheckbox you can select wether Kyamo should suggest values out of databse or not.
  • Edit Database will start a database-editor in the future. (not implemented yet)

• Directory-Settings

  • Reading path
    • This directory sets the path where kyamo searches for musicfiles.
    • You can set this directory also by dropping directories or musicfiles into K-Yamo.
  • Destination path
    • This directory sets the path where propper tagged files are stored when cleanup is used.
    • It is also the directory where the ripper puts the ready files
  • Reject path
    • This directory is the path where all files that have incomplete tags are put in
  • Temp path
    • This directory is the path where the cd-ripper stores all temporary files.

• Filesaving Settings

  • Save with Tagtype selects with wich tagtype the files are saved.
    Id3v1 and Id3v2.3 can be read by every app, but Id3v2.4 is not recognized by all apps that use id3lib.
  • The Filter
    You can construct a filter for cleanup-function. Also the Ripper uses this filter.
    Just construct your own type, how you want your files sorted.
    For Example: #GENRE#/#BAND#/#ALBUM#/#TRACK#-#SONG#
    What is standing up there means.
    • Make a second directorie with the bandname in tag
    • Make a third directory out of the albumname
    • Create a file with the name:
      Tracknumber - Songname
    • The /-Sign means: create a new directory with the mnemnomic in front.
  • Pictures in directories
    • If you set the Checkbox, there are pictures saved in the destinationdirectory
    • You can set a filename to use
    • The Format-box holds the desired imageformat
    • And The Size-box says how big the stored image should be.
  • Delete Settings
    • Overwrite selects if files are overwritten, if they would be double.
    • If Bitrate is higher says that files are only overwritten, when the bitrate of the new file is higher.
    • Move Files means that files are not copied by cleanup-function, but moved.

• Internet Settings

  • Select if you want to use freedb-support in cd CD-Ripper.
  • Select a Freedb-Server from list or enter it by hand. (near Mirror means faster lookup)
  • Select if Tagguesser can search with musicbrainz for missing tagparts if musicbrainzsupport is checked.
  • You can set a loginname for freedb, but it is not needed.

The Tagger

• The files tree
  You can select single or multiple files, or directories. (multiple select with shift and control also works)
  In the bottom line is standing how much files are selected at the moment.
  The right line shows the status of the file.
  • Red Flag means changed, and not saved yet.
  • Green hook means that nothing is changed on that file.
  • If you press Save file(s) the ID3-tags of the selected file(s) is(are) saved.
  • If you press Cleanup , all selected files are cleaned up using the set filter in settings.
    The names are generated out of the ID3-tags. (v2-tags are prefered)
  • If you press Guess tags , K-Yamo tries to find a filter that matches the selected filenames.
    On first file it pops up witch a dialog, where you have to select the right filter, if it finds matches.
    If you select new filter, or K-Yamo isn't able find any filters, that match the selected file, it opens the filter-generator. (see below this section)
    If K-Yamo is not able to fill in the tags complete by filenameguessing, it tries to fetch information from musicbrainz, if it is activated in settings.
  • If MySQL-support is activated, all the comboboxes are filled with suggests out of the database.
    For example: If you select as bandname Spocks Beard, or type it in, the comboboxes for album and song are filled with songs and albums from Spocks Beard in your database. This really helps tagging large amounts of files, and will be even more usefull, when I will manage to write the freedb-support for the tagger.

The Filtergenerator

This dialog comes up, if you need to make a new filter for tagguessing. There are 4 lines in this dialog.

• The Actual filter line shows you, the filter, as it is at the moment.
• The Second line shows you the file, you need to match with.
  You can select some text witch the mouse there, and than click on any mnemnomic in the
• 3rd line to select this part of the text as,for example, #TITLE#-mnemnomic.
  You can't select nonse, cause K-Yamo will prevent you from selcting things double.
  You always need to leave some signs between the mnemnomics, cause otherwise there is nothing the tagguesser can find to decide what text is for what mnemnomic. But that is a thing that the dialog tells you, if you try it the wrong way.
• The 4th line shows only 3 buttons, that should be relative selfexplaning.
  If you click on Ok the actual filter is used, and stored in the file "~/.k-yamo.filters" .
  You don't have to make any filter twice, cause next time all filters are loaded, when you use guess again.
  The restore button clears anything you did on the filter, and returns the startvalues again.
  This makes sense if you made a wrong entry.
  

The Ripper

• Tags
  Pretty selfexplaining I think.
• MySQL-support is also working in the ripper.
• Press read cd-info to get the TOC from the CD and make a freedb-lookup. Than the songbox will be filled with the songs and their names. You can select wich one(s) you want to rip. Select all just selects all songs.
• You can set the tags by hand also, if freedb doesnt know the disk, what is really rare.
• You can set a front-cover to save into the MP3-files by clicking on select cover. You can also drag a picture into K-Yamo to set it as front-cover.
• If you press start ripping the selected tracks are read out and converted to mp3. The converted files go renamed with the filter into the destination-directory.
• If you press start ripping the selected tracks are read out and converted to mp3. The converted files go renamed with the filter into the destination-directory.