🔥 MoltenLava

MoltenLava is a Swift package that provides a real-time renderer for Lava animation format using Metal. It enables efficient tile-based animation playback with real-time performance on Apple platforms.

Designed to work seamlessly on macOS & iOS.

✨ Features

• 🔁 Real-time playback of Lava animations
• 🎨 Tile-based frame decoding using MTLBlitCommandEncoder
• 📦 Parses .lava/.olava animation manifests and image frames
• 📱 Cross-platform: macOS & iOS
• 💡 Smooth real-time playback via LavaView

🚀 Getting Started

Add MoltenLava to your Swift package dependencies:

dependencies: [
    .package(url: "https://github.com/OpenLavaFormat/MoltenLava.git", from: "0.1.0")
]

Or add it to your Xcode project using File > Add Packages...

📸 Example

Check out the example project that demonstrates how to use MoltenLava to render Lava animations in a SwiftUI application:

OpenLava/Examples/MoltenLavaExample

📂 File Format

This package plays back Lava animations packaged as either:

• Folders containing:
  • manifest.json: animation metadata and frame diffs
  • Image frames: referenced in the manifest by filename

🤝 Contributing

Contributions are welcome!

Feel free to open an issue or submit a PR if you'd like to improve rendering performance, support new features, or extend platform support.

📄 License

MIT License © 2025 AlexStrNik