File	Date	Author	Commit
bin	2013-07-03	Евгений Козлов	[52f94e] 0.4.1: pp [play/pause]
ebuilds	2013-07-03	Евгений Козлов	[2ce220] added ebuild files for: mpd 0.17.*
lib	2011-08-20	dzheika	[452bbc] [0.3-pre -> 0.4.0]:
README	2013-07-03	Евгений Козлов	[52f94e] 0.4.1: pp [play/pause]
mpd_dzh.py	2013-07-03	Евгений Козлов	[52f94e] 0.4.1: pp [play/pause]

Read Me

1. The XChat plugin
 * Place the script file (mpd_dzh.py) into `~/.xchat2` directory, xchat will
   load it automatically on startup. Also, you can load it on the fly:
     [xchat]: /py load mpd_dzh.py
   or reload:
     [xchat]: /py reload mpd_dzh
 * Type:
     [xchat]: /mpd help
 *** NOTE: xchat must supports a python scripting

2. The Console implementation
 * Place the `bin/xmpd` file into your bin directory (usually it's a `~/bin`)
   and make it executable (chmod +x)
 * Place the `lib/stub/python/xchat.py` file into `~/lib/stub/python/xchat.py`
 * Type:
     user@host:~$ xmpd help
 *** NOTE: all command extensions should be passed as options:
           `/mpdsr` => `xmpd -sr` (but not `xmpd -s -r`)
 *** NOTE: path to the bin directory should be added to the $PATH environment
           variable (recommended)
 *** NOTE: path to the `xchat.py` stub file can be changed, but it requires
           editing of the `xmpd` script file

3. The extra-tags patch features

  Introduction:
    This plugin supports a non-standard tags for displaying information
    about current song. So, added tags by this patch:
      [x] Subtitle              (>= 0.16)
      [x] DiscSubtitle          (>= 0.16)
      [+] RomaArtist            (>= 0.15.8-r2)
      [+] RomaAlbum             (>= 0.15.8-r2)
      [+] RomaAlbumArtist       (>= 0.16)
      [+] RomaTitle             (>= 0.15.8-r2)
      [+] RomaSubtitle          (>= 0.16)
      [+] RomaDiscSubtitle      (>= 0.16)
    (x - standard tag, but is not supported by mpd)
    (+ - non-standard tag, added by me for my purposes)
    All tags with a 'Roma' prefix are the roma-tags.
    
    What are roma-tags?

  Roma-tags:
    For japanese (and other) titles tags can be written in a non-latin
    characters, but not all IRC networks supports unicode...

    Do you know about (japanese) romanization?

    So, these tags contains a romanized titles of a song. For example,
    a 'RomaArtist' tag contains a romanized artist:
      Artist: 陰陽座
      RomaArtist: Onmyouza

  Using roma-tags:
    The XChat plugin supports all roma-tags (with a 'Roma' prefix) and uses
    them as tags with same names without 'Roma' prefix, for example:
    'RomaAlbum' tag can be used as 'Album' tag.

    How to use it?

    For using it you should add a 'r' postfix to the xchat command:
      [xchat]: /mpdr [args...]
    or add a '-r' option to the console command:
      user@host:~$ xmpd -r [args...]

    If roma-tags will not be found, then default tags will be used.