TL;DR: Shimeji-ee is a Java application, so it needs a working Java runtime — install Java, check your build's README if the newest version doesn't work, and make sure .jar files open with Java. If Windows or an antivirus blocked the file, that's a screening step, not a verdict — the fixes are below. And if you'd rather not babysit a Java runtime at all, the bottom of this page has a no-Java route to a desktop pet.
Which symptom do you have?
| Symptom | Most likely cause | Jump to |
|---|---|---|
| Double-click and nothing happens — or a window flashes and closes | Java missing, or the wrong version for your build | Fix 1 |
"How do you want to open this file?" or 'java' is not recognized | The .jar isn't associated with Java | Fix 2 |
| "Windows protected your PC" or an antivirus pop-up | The file got blocked | Fix 3 |
| It opens, but the pet is clipped, edge-locked, or off-screen | Display scaling or monitor quirk | Fix 4 |
Fix 1 — Shimeji needs a Java runtime (this is the usual cause)
The classic desktop Shimeji — Shimeji-ee, the open-source build from kilkakon.com — is a Java application. No working Java runtime, no Shimeji: the double-click either does nothing visible or flashes a console window that closes instantly. Neither Windows nor macOS ships with Java, so a fresh computer fails right here by default. If you're setting Shimeji up from scratch, the setup walkthrough covers the whole install.
The fix, in order:
- Install current Java from java.com, then try Shimeji again. This alone clears most cases.
- Still nothing? Think version, not presence. Some Shimeji builds are older than today's newest runtimes, so the newest Java isn't automatically the right one. Check the README that came inside your Shimeji zip — if it names a Java version, install that one. This is the one place "newest" and "correct" don't always match.
- One healthy install is enough. To prove Java itself works, open a
command prompt and run
java -version— if it prints a version number, the runtime is fine and your real problem is Fix 2 or Fix 3.
If installing Java changes the symptom — now Windows asks how to open the file — that's progress, not a new problem. On to Fix 2.
Fix 2 — "Java isn't recognized," or the .jar won't associate
Three faces of the same root cause: double-clicking Shimeji-ee.jar opens an
archive manager full of folders, or Windows asks "How do you want to open this file?",
or a command line answers 'java' is not recognized as an internal or external
command. In every variant, Windows doesn't know the .jar is supposed to run on
Java.
- Point the .jar at Java. Right-click the .jar → Open with → Choose another app → look for Java(TM) Platform SE binary, tick "Always use this app", confirm. No Java in that list? Java isn't installed cleanly — back to Fix 1.
- Or skip the association entirely. Most Shimeji-ee downloads include a
Shimeji-ee.exethat launches the program without any file-association dance — run that instead. - Command-line route. Open a terminal in the Shimeji folder and run
java -jar Shimeji-ee.jar. If you get "not recognized", Java is missing or not on your PATH — reinstalling Java with the installer's default options usually repairs the PATH for you.
Fix 3 — Windows blocked it (SmartScreen, Defender, your antivirus)
The symptom: a blue "Windows protected your PC" SmartScreen dialog on first launch, a downloaded file that vanishes, or your antivirus quarantining the zip. What's happening: files from the internet carry a provenance marker, and unsigned apps get screened. Shimeji-ee is open-source and widely used, but it isn't code-signed, so Windows treats it like any unknown publisher. That's a screening step, not a verdict — but it deserves a real look every time, because the same warning also covers files that genuinely are bad.
- SmartScreen: click More info → Run anyway. (That flow is the standard path for any unsigned app, ours included.)
- Downloaded zip marked as blocked: right-click the file → Properties → tick Unblock → OK, then extract it fully.
- Antivirus quarantined it: open the quarantine / protection history, and restore the file if it came from the official source — kilkakon.com.
- The universal check — don't take anyone's word for it, ours included:
in a command prompt run
certutil -hashfile Shimeji-ee.zip SHA256, then paste the hash into VirusTotal to see dozens of engines' verdicts on that exact file. Ten seconds, free, and it works for any .exe or .jar — including installers from this site: our own installer gets the same treatment, and Is DeskSprite safe? covers what to expect from it (SmartScreen, what the app accesses, verification).
One exception: if the file came from an ad-covered mirror rather than kilkakon.com, don't fight the antivirus — that's the one case where the block is doing its job. Delete it and get the original. The safety breakdown covers where download risks actually come from.
Fix 4 — It opens, but something's off
- Only part of the pet renders, edges clipped. Windows display scaling above 100% can clip the pet's transparent window. Set scaling to 100% (Settings → System → Display), restart Shimeji, and try intermediate values from there.
- Walking the screen edges or the taskbar. That's not a bug — edges are their walkways. Grab one with the mouse and let go mid-screen: it dangles, then drops where you released it.
- Won't drag, or it throws your windows around. Dragging means click and hold. And every thrown window comes back: tray icon → Restore windows.
- Second monitor stays empty. Most builds spawn characters on the primary display only and don't relocate on their own. If you want them on the other screen, try setting that display as your main one while you use Shimeji.
Does Shimeji need Java?
Yes. The classic desktop Shimeji — including Shimeji-ee — is written in Java. It doesn't use Java optionally; the program is a Java application, so a working runtime is not negotiable.
What that costs in practice, stated plainly: one more runtime to install and keep updated; one more thing that can silently break — a Java update can leave an older Shimeji build unable to launch, which is the classic "it worked yesterday" story; and one more step between download and pet on screen.
If you're attached to a specific Shimeji mascot, all of that is worth it — fix it once with the steps above and enjoy. But if what you actually want is a companion on your desktop, there's a second road: native desktop pets that ship as one installer with no Java and no runtime maintenance. DeskSprite is one of them — Windows 10/11 and macOS 12+, and the built-in pet moves in on first launch, free to start. Same little companion, fewer moving parts.
Shimeji won't open on Windows 11
Windows 11 adds friction in three specific places — none fatal, all worth knowing:
- No Java out of the box. A fresh Windows 11 has no Java preinstalled, so Shimeji fails at Fix 1 by default. Install Java before troubleshooting anything else.
- SmartScreen is stricter with downloaded files. First launch of the unsigned app shows the blue warning — More info → Run anyway (Fix 3). If a download disappears before you even see it, check Windows Security → Protection history.
- No .jar association on a fresh install. Until Java is properly installed, Windows 11 has nothing to open a .jar with — right-click → Open with → Choose another app is the flow (Fix 2).
One rule that predates Windows 11 and outlives it: extract the zip fully before running anything inside it. Running Shimeji from inside the zip preview breaks it on every Windows version.
Shimeji won't open on macOS
A different failure world. Shimeji's official builds are Windows-centric, so on macOS you're running community ports — each one a volunteer-maintained bundle of the app, a Java runtime, and macOS-specific glue, each aging at its own pace. The classic patterns: a macOS update displaces the port's Java runtime (reinstall a current Java), Gatekeeper blocks the unsigned port (right-click → Open to allow it once), or the port simply predates your macOS version and needs a rebuild.
The full causes-and-fixes checklist lives in Shimeji not working on Mac. And if you'd rather not install Java on a Mac at all, native options exist — DeskSprite ships as a regular .dmg (macOS 12+, Apple silicon and Intel).
Still stuck? Try this order
- Prove Java itself works. Command prompt →
java -version→ it should print a version number. An error means Java is missing or not on your PATH → Fix 1. - Match the version. Install the Java version your build's documentation names, not just the newest → Fix 1.
- Re-download from the official source (kilkakon.com) and unzip completely — a half-downloaded file or a mirror's repack is unfixable at your end. Anything from a host you don't recognize, scan first (Fix 3).
- Launch once from an administrator command prompt —
java -jar Shimeji-ee.jarin the Shimeji folder. Permission-tight setups fail silently, and the console output will name the actual error. - Try a different Shimeji build — or a different shape of app altogether: a native desktop pet skips this entire list.
FAQ
Why won't Shimeji open on Windows 11?
Usually one of three things: Java isn't installed (Windows 11 doesn't ship with it), the .jar file isn't associated with Java, or Windows SmartScreen or an antivirus blocked the unsigned file on first run. Install current Java from java.com, run Shimeji-ee.exe again, and choose "More info → Run anyway" if SmartScreen appears. The fix-by-symptom walkthrough is on this page.
Does Shimeji need Java?
Yes — the classic desktop Shimeji, including Shimeji-ee, is a Java application, so it needs a working Java runtime installed. That dependency is also why Shimeji sometimes refuses to open: no runtime, the wrong version, or a Java update that leaves an older build behind. If you'd rather have a desktop pet without the Java layer, native alternatives like DeskSprite ship as a single installer with no runtime to maintain.
Which Java version does Shimeji need?
It depends on the build you downloaded. The current Java from java.com is the right first try, but some Shimeji builds are older than today's newest runtimes — if Shimeji still won't open with Java installed, install the version your build's own documentation names (check the README inside the Shimeji zip). A version mismatch usually looks exactly like this: Java installed, double-click, nothing happens.
Why can't I run Shimeji?
Four usual causes, in order of likelihood: Java isn't installed; Java is installed but it's the wrong version for your Shimeji build; Windows doesn't associate .jar files with Java, so double-clicking opens an archive manager instead; or Windows SmartScreen or your antivirus blocked the file. All four have fixes on this page — start with the symptom table at the top.
Does Shimeji drain the battery?
It can, because Shimeji renders every animation frame live. One character idles lightly; a crowd of them — the multiply feature makes this easy to reach — takes a real slice of CPU and RAM, and on a laptop that's battery. If your fans spin up, use the tray icon's "Reduce to one" and the drain drops with the crowd.
Can you trust Shimeji? Is it safe?
Yes, from the official sources: the desktop program Shimeji-ee is open-source (kilkakon.com), and the browser extension goes through Chrome Web Store review. The real risk lives in lookalike download sites and fan packs from unknown hosts — scan anything you're unsure about on VirusTotal. We keep a full source-by-source breakdown in Is Shimeji safe?
Does Shimeji use AI?
No — classic Shimeji's behaviors are pre-scripted animation frames, which is why custom characters are hand-drawn frame by frame. If you like the desktop-pet idea and want AI in the loop, DeskSprite's pet maker generates a full animated pet from 1–3 of your photos.
Is there a version of Shimeji that doesn't need Java?
Not from the classic project itself — every desktop Shimeji build, including the Mac community ports, runs on Java. What exists instead is the wider desktop-pet category: native apps that deliver the same companion-on-your-screen idea with no Java at all. DeskSprite is one — a single installer for Windows and macOS, and the built-in pet appears on first launch.
Want a pet on your screen without any of this?
DeskSprite is a native desktop pet for Windows 10/11 and macOS 12+. No Java, no runtime maintenance, no troubleshooting ladder: install it and the built-in pet moves in. Want a character no one has ever drawn? The AI pet maker turns 1–3 of your photos into a fully animated pet.
Download DeskSprite — Free Make Your Own Desktop Pet
Free · No account needed · No Java required