Shimeji - Little Fun Guys for your Windows Desktop
==================================================

You will need
-------------
* Windows XP or higher
* Java Run-Time Environment (JRE)
* A copy of Shimeji-EE (English Edition)
  from [their website](https://code.google.com/p/shimeji-ee/)
  Get the 'Mischievous' flavour instead of 'Calm' if you have a choice.

What if I don't use MS Windows?
-------------------------------
* Linux users can use xpenguins; check 
  [Mozai's website](http://nepeta.mozai.com/shimeji/) to see if he
  ever finished that "shimeji-to-xpenguins" project.
* Macintosh OSX users are stuck; the window manager doesn't accomodate 
  the full-screen-aware-of-other-windows that shimeji require.  There's
  an old desktop toy called [Neko](http://nepeta.mozai.com/shimeji/#mac)
  that does something similar but it's not at all interactive.
* iPad and Android users, there's no place in their design for shimeji,
  nevermind in their software.  You're totally Sorry Outta Luck (SOL).


How do I use this stuff?
------------------------
* Extract the Shimeji-ee software to a folder.
* Copy the folder and it's contents to a new name (i.e.: "Shimeji-Sollux")
* In the "conf/" subfolder, remove 'behaviours.xml and 'actions.xml'.
  Replace those two files with what you found in this *.zip
* In the "img/" subfolder, remove any 'shime*.png' files
  Replace those files with what you found in this *.zip.
* If there is 'profile.png', 'banner.bmp' or 'icon.ico' in this *.zip,
  put them in the "img/" subfolder, replacing whatever you found there.
* Launch "Shimeji-ee.exe" from the new copied folder.
  An icon should appear in your systray for controlling & configuring
  your new desktop buddy.  There's supposed to be a setting in there for
  turning off the feature where a shimeji will grab a window and throw
  it off your desktop.


What if I have problems with the software?
------------------------------------------
Sorry dude; I know art, animation and XML files, but since I don't
own a windows computer, so I couldn't help you with running the
software even if I tried.  You're better off going to the 
[Shimeji-ee website](https://code.google.com/p/shimeji-ee/) and reading
their instructions or asking them for help.


What if I want to make my own Shimeji?
--------------------------------------
The easiest way to do it is to re-use the behaviours & actions of another
shimeji you like, and redraw the art.  You will need to replace each
of the img/shime*.png files (even the ones that seem like repeats),
with *exactly* the same height and width as the ones you are replacing.
A drawing program that lets you use layers with a sliding transparency
(like The GIMP) would be good for that.

Don't forget to use a transparent background while you're working on
the art, because removing a coloured background will leave a "halo"
around any smooth lines you made while you were drawing.


Why "Shimeji" ?
---------------
I mentioned the software is originally Japanese, right?  The prototypes
were little mushroom-people, who would reproduce by budding.  "Shimeji"
is a type of mushroom.  That's also why I made the "fun guy" joke at
the beginning.  Fun guy -- fungi.  Get it?  No?  Well, I thought it
was clever.

This is also why some the reproduction frames seem really weird.  
The original shimeji actions.xml uses Frames 37-41 for pulling a new
mushroom out of the ground, and frames 42-46 are for a new mushroom to
reproduce by budding or metosis.  These are okay for fungi, but
might be distressing for humans, trolls, consorts or for
Prospitians/Dersites.  (Why do I get the feeling Lil' Cal would be
completely 0kay with this?  Oh god; the idea of a Lil' Cal shimeji is
terrifying.)


Who do I blame for this?
------------------------
* For the artwork in this *.zip file, see 'credits.txt'
* For this package and 00_readme.txt, a homestuck weirdo named Mozai.
* For translating Shimeji code to the more usable Shimeji-ee,
  a dude named [Relic](https://code.google.com/u/116280880410615163959/)
* For the original software, Yuki Yamada 
  of [Group Finity](http://www.group-finity.com/Shimeji/)

-- Mozai, 2012-03-12

