General Setup Questions
Q: How do I create a Jacky skin?
A: To create a custom skin, you need to organize your sprite PNG frames into specific animation folders (with a required Idle folder containing at least 4 frames) and include a manifest.json file at the root. For complete guidelines, folder naming conventions, and setup instructions, check out the Skins & Animations Reference.
Q: Why does Jacky fail to load custom skins?
A: Ensure your skin .zip or .jacky archive contains a valid manifest.json file at the root (not nested inside folders). You can package skins, routines, or language packs using the Manifest Builder. Also, verify that the Idle folder is present. The Idle folder is required for any fallback chains to load properly. (Upon installation, Jacky automatically compiles manifest.json into the internal character.json runtime configuration).
Q: Do all .jacky files require a manifest?
A: Yes. Every .jacky package file (whether it is a skin, custom routine, or language pack) must contain a valid manifest.json file at its root to load correctly. You can easily generate one using the Manifest Builder.
Q: Why is Jacky not responding intelligently or processing commands?
A: To get the full experience and enable Jacky to think, reason, and understand your commands, you need to configure and enable an LLM provider. Go to settings and set up your preferred model and API key. For more details, see the LLM Settings Guide.
Q: Can I stop Jacky from moving or pushing my active windows?
A: Yes, if you find Jacky manipulating or pushing your windows annoying, you can disable this behavior. Go to Settings -> Features (Características) and toggle off Permitir empujar ventanas (Allow push windows). Check the Features Settings Guide for more information.
Q: How do I integrate smart home features with Jacky?
A: To use smart home features, you need to set up and run an independent Home Assistant instance (for example, on a Raspberry Pi or a local Docker container) where your IoT devices are integrated. Once configured, you can connect Jacky to it. See the Home Assistant Integration Guide for setup steps.
Q: How do I enable screen interaction clicks?
A: You must grant explicit permissions in Jacky's tray settings panel. Go to Settings -> Permissions and check Allow Screen Interaction (allow_screen_interact) and Allow Vision (allow_vision). Without these, clicks will be skipped for safety.
Error Codes
NEEDS_HA_PERM:allow_smart_home: Grant the smart-home permission check box in settings.NEEDS_CONSENT:<connection>: The OAuth access token has expired and cannot be auto-refreshed. Click the "Reconnect" button in your tray options.HA_UNREACHABLE: Ensure your Home Assistant local URL is correct and active.