Skip to content

OpenAnima v1.0.0-rc1

Choose a tag to compare

View all tags
@Ertugrulmutlu Ertugrulmutlu released this 02 May 21:11
v1.0.0-rc1
a491bf8

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?
Assets 3
Loading