{"id":35710928,"url":"https://github.com/dalekcraft2/shimeji-desktop","last_synced_at":"2026-05-20T01:09:38.421Z","repository":{"id":207253702,"uuid":"718258944","full_name":"DalekCraft2/Shimeji-Desktop","owner":"DalekCraft2","description":"A port of Shimeji-ee from JRE 6 to JDK 11. Also has many code changes and bug fixes, but attempts to preserve backward compatibility.","archived":false,"fork":false,"pushed_at":"2026-04-20T21:54:14.000Z","size":6255,"stargazers_count":31,"open_issues_count":8,"forks_count":7,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-20T23:36:38.522Z","etag":null,"topics":["awt","awt-game","desktop-pet","java","pet","shimeji","shimeji-ee","swing"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DalekCraft2.png","metadata":{"files":{"readme":"README.md","changelog":"changelog.txt","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-11-13T18:01:46.000Z","updated_at":"2026-04-20T21:53:44.000Z","dependencies_parsed_at":"2025-02-06T20:28:27.656Z","dependency_job_id":"c3db3f74-7b63-4ce4-9fa9-3b15a3ff93c1","html_url":"https://github.com/DalekCraft2/Shimeji-Desktop","commit_stats":null,"previous_names":["dalekcraft2/shimeji-desktop"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/DalekCraft2/Shimeji-Desktop","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DalekCraft2%2FShimeji-Desktop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DalekCraft2%2FShimeji-Desktop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DalekCraft2%2FShimeji-Desktop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DalekCraft2%2FShimeji-Desktop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DalekCraft2","download_url":"https://codeload.github.com/DalekCraft2/Shimeji-Desktop/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DalekCraft2%2FShimeji-Desktop/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32165201,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-23T02:19:40.750Z","status":"ssl_error","status_checked_at":"2026-04-23T02:17:55.737Z","response_time":53,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["awt","awt-game","desktop-pet","java","pet","shimeji","shimeji-ee","swing"],"created_at":"2026-01-06T04:10:26.689Z","updated_at":"2026-05-20T01:09:38.412Z","avatar_url":"https://github.com/DalekCraft2.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Fork notes\n\nThis is a fork of [Kilkakon's fork](https://kilkakon.com/shimeji/) of\n[Shimeji-ee](https://code.google.com/archive/p/shimeji-ee/) that updates the runtime from JRE 6 to JDK 25.\nIt also contains:\n\n* Bug fixes\n* More detailed log messages\n* Fixes in the default mascot action/behavior XML files\n* More documentation (including comments and documentation from the original Shimeji, now translated through a better\n  Google Translate than before)\n* Updated dependencies\n* Formatting fixes\n* Proper DPI scaling\n* and a lot more that I don't have the energy to list.\n\nI have also switched the project from Ant to Maven, and ported the `launch4j.xml` file from the original Shimeji to the\nLaunch4j Maven Plugin.\n\nIt also contains Linux support based on code from [asdfman's linux-shimeji](https://github.com/asdfman/linux-shimeji),\nmacOS support based on code from [nonowarn's shimeji4mac](https://github.com/nonowarn/shimeji4mac), and some inspiration\nfrom [LavenderSnek's ShimejiEE-cross-platform](https://github.com/LavenderSnek/ShimejiEE-cross-platform).\n\nThe rest of this file is the original README, albeit ported to Markdown and with slightly more up-to-date information.\n\n# Shimeji-ee: Shimeji English Enhanced\n\nShimeji-ee is a desktop mascot for Windows, macOS, and Linux that freely wanders and plays around the screen. The mascot\nis very configurable; its actions are defined through XML and its animations/images can be (painstakingly) customized.\nShimeji was originally created by Yuki Yamada of\n[Group Finity](https://web.archive.org/web/20160901003054/http://www.group-finity.com/Shimeji/). This branch of the\noriginal Shimeji project not only translates the program/source to English, but adds additional enhancements to\nShimeji by Kilkakon and other members of the community.\n\n## Contents\n\n1. [Links](#links)\n2. [Requirements](#requirements)\n3. [How to Start](#how-to-start)\n4. [Basic Configuration](#basic-configuration)\n5. [Advanced Configuration](#advanced-configuration)\n6. [How to Quit](#how-to-quit)\n7. [How to Uninstall](#how-to-uninstall)\n8. [Licensing](#licensing)\n9. [Trouble Shooting](#trouble-shooting)\n\n## Links\n\n* [Kilkakon's Shimeji homepage](https://kilkakon.com/shimeji/)\n* [linux-shimeji repository](https://github.com/asdfman/linux-shimeji)\n* [shimeji4mac repository](https://github.com/nonowarn/shimeji4mac)\n* [ShimejiEE-cross-platform repository](https://github.com/LavenderSnek/ShimejiEE-cross-platform)\n* [Shimeji-ee homepage](https://code.google.com/archive/p/shimeji-ee/)\n* [Shimeji homepage (archive)](https://web.archive.org/web/20160901003054/http://www.group-finity.com/Shimeji/)\n* [Shimeji mirror download](https://www.vector.co.jp/soft/winnt/amuse/se476479.html)\n\n## Requirements\n\n* Windows Vista or newer / macOS / Linux (X11)\n* Java 25 or newer\n\n## How to Start\n\n1. Open the Shimeji-ee JAR file (`Shimeji-ee.jar`).\n    * On Windows, you can alternatively open `Shimeji-ee.exe`.\n    * On macOS/Linux, you can alternatively open `Shimeji-ee`.\n2. Right-click the tray icon for general options.\n3. Right-click a Shimeji for options relating to it.\n\nFor a tutorial on how to get Shimeji running, watch [this video](https://www.youtube.com/watch?v=S7fPCGh5xxo).\n\nYou can also watch the [FAQ](https://www.youtube.com/watch?v=A1y9C1Vbn6Q) if you encounter problems.\n\nYou can also join Kilkakon's [Discord server](https://discord.gg/dcJGAn3).\n\n## Basic Configuration\n\nIf you want multiple Shimeji types, you must have multiple image sets. Basically, you put different folders with the\ncorrect Shimeji images under the `img` directory.\n\nFor example, if you want to add, say, a new Batman Shimeji:\n\n1. Create an `img/Batman` folder.\n2. You must have an image set that mimics the contents of `img/Shimeji`. Create and put new versions of `shime1.png` -\n   `shime46.png` (with Batman images, of course) in the `img/Batman` folder. The filenames must be the same as the\n   `img/Shimeji` files. Refer to `img/Shimeji` for the proper character positions.\n3. Start Shimeji-ee. Now Shimeji and Batman will drop. Right-click Batman to perform Batman specific options. Pressing\n   \"Call Shimeji\" in the tray icon menu will randomly create and add either Shimeji or Batman.\n\nWhen Shimeji-ee starts, one Shimeji for every image set in the `img` folder will be created. If you have too many image\nsets, a lot of your computer's memory will be used... so be careful.\n\nShimeji-ee will ignore all the image sets that are in the `img/unused` folder, so you can hide image sets in there.\nThere is also a tool, Image Set Chooser, that will let you select image sets at run time. It remembers previous options\nvia the `conf/settings.properties` file. Don't choose too many at once.\n\nFor more information, read through the configuration files in `conf/`. Most options are somewhat complicated, but it's\nnot too hard to limit the total number of Shimeji or to turn off certain behaviors (hint: set frequency to 0).\n\n## Advanced Configuration\n\nAll configuration files are located in the `conf` folders. In general, none of these should need to be touched.\n\nThe `logging.properties` file defines how logging errors is done.\n\nThe `actions.xml` file specifies the different actions Shimeji can do. When listing images, only include the file name.\nMore detail on this file will hopefully be added later.\n\nThe `behaviors.xml` file specifies when Shimeji performs each action. More detail on this file will hopefully be added\nlater.\n\nThe `settings.properties` file details which Shimeji are active as well as the windows with which they can interact.\nThese settings can be changed using the program itself.\n\nEach type of Shimeji is configured through:\n\n1. An image set. This is located in `img/[NAME]`. The image set must contain all image files specified in the actions\n   file.\n2. An actions file. Unless `img/[NAME]/conf/actions.xml` or `conf/[NAME]/actions.xml` exists, `conf/actions.xml` will\n   be used.\n3. A behaviors file. Unless `img/[NAME]/conf/behaviors.xml` or `conf/[NAME]/behaviors.xml` exists, `conf/behaviors.xml`\n   will be used.\n\nWhen Shimeji-ee starts, one Shimeji for every image set in the `img` folder will be created. If you have too many image\nsets, a lot of your computer's memory will be used... so be careful.\n\nShimeji-ee will ignore all the image sets that are in the `img/unused` folder, so you can hide image sets in there.\nThere is also a tool, Image Set Chooser, that will let you select image sets at run time. It remembers previous options\nvia the `conf/settings.properties` file. Don't choose too many at once.\n\nThe Image Set Chooser looks for the `shime1.png` image. If it's not found, no image set preview will be shown. Even if\nyou're not using an image named `shime1.png` in your image set, you should include one for the Image Set Chooser's sake.\n\nEditing an existing configuration is fairly straightforward, but writing a brand-new configuration file is very\ntime-consuming and requires a lot of trial and error. Hopefully someone will write a guide for it someday, but until\nthen, you'll have to look at the existing `conf` files to figure it out. Basically, for every behavior, there must be a\ncorresponding action. Actions and behaviors can be a sequence of other actions or behaviors.\n\nThe following actions must be present for the `actions.xml` to be valid:\n\n* ChaseMouse\n* Fall\n* Dragged\n* Thrown\n\nThe following behaviors must be present for the `behaviors.xml` to be valid:\n\n* ChaseMouse\n* Fall\n* Dragged\n* Thrown\n\nThe icon used for the system tray is `img/icon.png`.\n\n## How to Quit\n\nRight-click the tray icon of Shimeji-ee, and select \"Dismiss All\".\n\n## How to Uninstall\n\nDelete the unzipped folder.\n\n## Building\n\n1. Download the source code. This can be done by either downloading a ZIP file containing the source or using Git to\n   clone the repository to your computer. Both options are available through the green \"Code\" button at the top of the\n   GitHub page. Git is recommended if you plan to contribute changes to this repository.\n2. Install Java 25 or newer.\n3. Install [IntelliJ IDEA Community Edition](https://www.jetbrains.com/idea/download/).\n4. Open the source code directory in the IDE.\n5. Open the Maven tool window on the right side of the UI. The icon to open the window should look like an \"m\".\n6. Right-click the \"Shimeji-ee\" item and select \"Run Maven build\". This will build the project and output the files to\n   the `target/` directory. The distributable file should be a ZIP file named `Shimeji-ee_[version].zip`.\n\n## Licensing\n\nProgrammers may feel free to use the source. The Shimeji-ee source is under the New BSD license.\n\nShimeji by Yuki Yamada is licensed under the zlib/libpng license.\n\n## Trouble Shooting\n\nFor a tutorial on how to get Shimeji running, watch [this video](https://www.youtube.com/watch?v=S7fPCGh5xxo).\n\nYou can also watch the [FAQ](https://www.youtube.com/watch?v=A1y9C1Vbn6Q) if you encounter problems.\n\nYou can also join Kilkakon's [Discord server](https://discord.gg/dcJGAn3).\n\nShimeji-ee takes a LOT of time to start if you have a lot of image sets, so give it some time. Try moving all but one\nimage set from the `img` folder to the `img/unused` folder to see if you have a memory problem.\n\nIf the Shimeji-ee icon appears, but no Shimeji appear:\n\n1. Make sure you have the newest version of Shimeji-ee.\n2. Make sure you only have image set folders in your `img` directory.\n3. Make sure you have Java 25 or newer on your system.\n4. If you're somewhat computer savvy, you can try running Shimeji-ee from the command line. Navigate to the Shimeji-ee\n   directory and run this command: `\"C:\\Program Files\\Java\\jdk-25\\bin\\java\" -jar Shimeji-ee.jar`\n5. Try checking the log (`ShimejieeLogX.log`) for errors. If you find a bug (which is very likely), report it on\n   Kilkakon's Discord server.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdalekcraft2%2Fshimeji-desktop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdalekcraft2%2Fshimeji-desktop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdalekcraft2%2Fshimeji-desktop/lists"}