Skip to content

omar-khaled-opal/spoilerlog

Repository files navigation

🗺️ Ocarina of Time Randomizer Spoiler Log Viewer

Spoiler Log Viewer Banner

A lightweight and user-friendly **Flutter application** for viewing **Ocarina of Time Randomizer** spoiler logs.  

Instead of scrolling through long text files, this app organizes the spoiler log into clear sections, helping players quickly inspect item locations, entrance connections, settings, and progression paths—all from their phone or desktop.

📌 Overview

This project aims to make Ocarina of Time Randomizer spoiler logs more accessible by providing:

  • A clean and intuitive UI.

  • Fast navigation between spoiler sections.

  • Support for multiple log versions.

  • Cross-platform builds (Android, iOS, Windows, Linux, macOS).

Ideal for players who want to analyze seeds, track down missing items, or review randomized worlds during or after a playthrough.


✨ Features

  • 📁 Open any Ocarina of Time Randomizer spoiler log (.json).

  • 🔍 Instantly browse key sections:

  - Item Locations  

  - Entrance Shuffle Layout  

  - Starting Items  

  - Settings  

  - WotH/Barren hints (if available)  

  • 🎨 Clean Flutter UI with responsive layout.

  • 💾 Works on mobile and desktop.

  • ⚡ Fast parsing and navigation.

  • (More features coming soon…)


🗺️ Project Goals (Future Roadmap)

  • Search functionality inside logs  

  • Favorites / bookmarking sections  

  • Seed comparison tool  

  • Automatic detection of key progression items  

  • Light/Dark theme support  

  • Exporting formatted spoiler summaries  


🚀 Getting Started

Make sure you have Flutter installed:

🔗 https://flutter.dev/docs/get-started/install

1. Clone the repository

git clone <repository-url>

2. Navigate to the project folder

cd spoilerlog

3. Install dependencies

flutter pub get

🛠️ Building the Project

Android (APK)

flutter build apk --release

iOS

flutter build ios --release

Note: Building for iOS requires macOS and Xcode.


📦 Dependencies

| Package | Purpose |

|--------|---------|

| file_picker | Select files from device storage |

| flutter_svg | Render SVG assets (icons, UI elements) |


🧪 Dev Dependencies

| Package | Purpose |

|--------|---------|

| flutter_launcher_icons | Generate app icons |


🤝 Contributing

Contributions are welcome!  

Whether it's UI improvements, bug fixes, or adding new log parsing features, feel free to open issues or submit PRs.


📄 License

This project is open source under the MIT License.


Enjoy analyzing your seeds! 🎻💫  

This tool is made to enhance your Ocarina of Time Randomizer experience.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors