OpenAnima v1.1.0

OpenAnima v1.1.0

OpenAnima v1.1.0 focuses on better desktop overlay usability, especially for users with multiple monitors.

Highlights

• Added multi-monitor overlay support.
• Overlays can now move beyond the primary display.
• Secondary monitor placement is supported.
• Added monitor/display selection in the main UI.
• Improved overlay positioning and safer fallback behavior when monitor layouts change.

Added

• Multi-monitor detection for overlay placement.
• Support for dragging overlays across the full virtual desktop area.
• Support for monitor layouts where secondary displays may be placed to the left, right, or above the primary display.
• Monitor selection option for choosing where overlays should appear.

Fixed

• Fixed an issue where GIF and overlay windows were restricted to the primary monitor bounds.
• Fixed overlay placement behavior that could prevent users from moving overlays to secondary displays.

Changed

• Improved overlay positioning logic.
• Improved behavior when restoring overlay positions after restarting the app.
• Improved fallback handling when a previously selected monitor is no longer connected.

Download

Download the Windows build below and run:

OpenAnima.exe

V1.0 stable release

v1.0.0
OpenAnima v1.0.0 is the first public-ready release of the Windows desktop overlay engine.

Added
Modular package structure under openanima_app/ with separate assets, overlay, rendering, runtime, and UI domains.
Overlay persistence through config.json, including position, scale, opacity, speed, visibility, lock state, click-through state, always-on-top state, selected spritesheet animation, composite layer values, actions, and movement settings.
Local asset library and import workflow for files, asset folders, and asset packs.
Asset analyzer and setup dialog for configuring metadata-driven assets.
Desktop overlay management page and Inspector controls for selected overlays.
Support for static images, GIF, APNG, WebM, frame-folder animations, sprite strips, spritesheets, and composite UI / HUD assets.
Recovery tools for hidden, locked, click-through, or off-screen overlays.
Diagnostics and rotating file logs for packaged builds.
PyInstaller packaging readiness through OpenAnima.spec.
Notes
v1.0.0 is focused on local 2D desktop overlays for Windows.
3D model support is not included in v1.0.0.
WebM playback and alpha behavior depend on the local Qt Multimedia backend and installed codecs.

OpenAnima v1.0.0-rc1

OpenAnima v1.0.0-rc1 Release Materials

GitHub Release Notes

OpenAnima v1.0.0-rc1

OpenAnima is an open-source Windows desktop app for placing local 2D visual assets on your desktop as independent overlay windows.

This release is a v1.0.0-rc1 release candidate. It focuses on making the existing 2D overlay workflow more reliable, recoverable, and easier to diagnose before the final v1.0 release.

3D support is planned for exploration after v1.0. It is not included in this release.

Highlights

• Packaged Windows executable build: OpenAnima.exe
• More reliable config.json loading and saving
• Atomic config writes to reduce risk of broken saved sessions
• Corrupt config recovery with timestamped backups
• Schema versioning for saved config data
• Safer handling for missing, partial, invalid, or old saved configs
• Off-screen overlay recovery during restore
• Recovery tools for hidden, locked, click-through, or off-screen overlays
• System tray emergency actions
• File logging with rotating logs
• Diagnostics tab for version, paths, active overlays, and recent warnings/errors
• README and release checklist updates for v1.0 preparation
• PyInstaller spec-based packaging setup

Supported Asset Types

OpenAnima v1.0.0-rc1 supports:

• GIF overlays
• Static image overlays: PNG, JPG, JPEG, WEBP
• Frame-folder animations
• Sprite strips
• Spritesheets with metadata-defined animations
• Composite UI / HUD-style layered assets

A bundled demo/easter-egg GIF is included and appears in the Library.

Recovery And Reset Tools

The Active tab includes recovery actions for situations where users lose control of overlays:

• Bring all overlays to center
• Disable click-through for all overlays
• Unlock all overlays
• Show all overlays
• Hide all overlays
• Clear saved session / reset active overlays

The system tray also includes emergency actions:

• Show Control Panel
• Show all overlays
• Disable click-through for all
• Bring all overlays to center
• Exit

Diagnostics And Logging

The packaged app runs without a console window, so important warnings and errors are now written to:

logs/openanima.log

The Diagnostics tab shows:

• OpenAnima version
• Config path
• Current asset root
• Log file path
• Active overlay count
• Recent warnings/errors

It also includes buttons to open the logs folder and copy diagnostic info.

Safer Config Persistence

OpenAnima stores session state in config.json.

This release adds:

• Atomic config saves
• schema_version: 1
• Safe defaults for missing config files
• Corrupt JSON backup files named like config.corrupt.YYYYMMDD_HHMMSS.json
• Per-overlay validation so one bad saved overlay does not break the whole session
• Missing asset handling that skips only the affected overlays

Download And Run Notes

Download the Windows executable from this GitHub release, then run:

OpenAnima.exe

On first launch, OpenAnima creates local runtime files beside the executable:

assets/
config.json
logs/

If Windows SmartScreen appears, choose the normal "More info" / "Run anyway" flow only if you trust the downloaded file and source.

Known Limitations

• This is a release candidate, not the final v1.0 release.
• v1.0.0-rc1 is focused on Windows.
• 3D model support is not included.
• Sprite strips may need manual frame count, frame size, or crop correction.
• Spritesheets require metadata or setup through the import wizard.
• Composite UI assets may need manual layer alignment.
• The Composite UI editor is useful but not a full professional layout tool.
• Some third-party asset packs may need manual asset.json cleanup.
• Use third-party assets only when their license allows it.

Testing Requested

If you try this release candidate, useful feedback includes:

• Does the packaged EXE launch cleanly?
• Do overlays restore correctly after restart?
• Do recovery actions work if overlays are hidden, locked, click-through, or off-screen?
• Does the Diagnostics tab show useful paths and warnings?
• Do imported assets behave as expected?
• Does logs/openanima.log capture useful information when something fails?

OpenAnima v0.2 Preview — Desktop Asset Engine Foundation

OpenAnima v0.2 Preview — Desktop Asset Engine Foundation

This preview release expands OpenAnima from a GIF overlay tool into a metadata-driven desktop asset overlay engine for Windows.

What’s new

• Generic asset analyzer and import wizard
• asset.json metadata support
• Support for GIFs, static images, frame-folder animations, sprite strips, spritesheets, and composite UI/HUD assets
• Sprite strip setup with frame count, frame size, crop fields, live preview grid, and frame export
• Spritesheet rendering with named animations
• Composite UI/HUD rendering with layered images and runtime sliders
• Improved Editor tab and Asset Setup dialog layouts
• Safer metadata validation and error handling
• Backward compatibility for existing GIF/static/frame-folder workflows

Supported asset types

• GIF
• Static image
• Frame-folder animation
• Sprite strip
• Spritesheet
• Composite UI / HUD

Preview notice

This is a preview release. Some advanced game asset workflows may still require manual setup, especially sprite strips, spritesheets, and composite UI layouts.

Known limitations

• Sprite strips may require manual frame count or frame size correction.
• Some sprite strips with unusual padding may need manual crop values.
• Spritesheets require metadata or setup through the import wizard.
• Composite UI assets may require manual layer alignment.
• The Composite UI editor is functional but not a full professional layout tool.
• 3D model support is not included yet.
• Some unusual asset packs may still need manual asset.json editing.

OpenAnima v0.1.0

🚀 OpenAnima v0.1.0

Initial public release of OpenAnima — an open-source desktop animation overlay engine.

✨ Features

• Drag and place animated GIFs anywhere on your desktop
• Multiple animations supported simultaneously
• Live editing via Control Panel:
  • Scale
  • Opacity
  • Speed
• Click-through mode
• Always-on-top support
• Lock / unlock movement
• Persistent state (position and settings saved)
• Asset pack system
• System tray integration

📦 Usage

1. Launch OpenAnima.exe
2. Open Control Panel
3. Import a GIF
4. Add it to your desktop
5. Customize it in real time

🧠 Notes

• The app creates assets/ and config.json automatically on first launch
• Built with Python + PySide6
• Fully open-source

---

If you like the project, consider giving it a ⭐