FlagForge

A free and open-source desktop application for solving, analyzing, and documenting Capture The Flag (CTF) challenges.

Organize challenges • Analyze attachments • Convert data • Learn techniques • Write better writeups

---

Overview

FlagForge is an all-in-one workspace designed specifically for Capture The Flag competitions.

Instead of switching between note-taking applications, CyberChef, hex editors, metadata viewers, and dozens of browser tabs, FlagForge brings everything together into a single desktop application.

Whether you're learning your first CTF or competing with a team, FlagForge helps you stay organized from the moment you open a challenge until you submit the flag.

---

Features

1. Challenge Management

• Organize CTFs into workspaces and projects
• Create individual challenges
• Markdown writeups
• Tags and metadata
• Attach notes and flags
• Local file-based storage

---

2. Attachment Tools

Upload files to any challenge and analyze them directly within FlagForge.

Supported attachments include:

• Images
• Archives
• Executables
• Source code
• PCAP files
• Documents
• Audio
• Video
• Memory dumps
• Disk images
• And more

FlagForge automatically detects the file type and provides relevant analysis tools.

Examples include:

• Image inspection
• Hex viewer
• Metadata viewer
• Strings extraction
• Archive explorer
• Hash generation
• Binary analysis

---

3. Converter Tools

Inspired by CyberChef, the Converter section provides numerous utilities for everyday CTF tasks.

Supported categories include:

• Encodings
• Cryptography
• Hashing
• Data conversions
• Binary manipulation
• Text transformations

Examples:

• Base64
• Base32
• Hex
• Binary
• URL Encoding
• AES
• XOR
• ROT13
• Caesar Cipher
• MD5
• SHA-256
• SHA-512

More tools are continuously being added.

---

4. Built-in Documentation

Learn while you solve.

The documentation contains:

• CTF basics
• Reverse Engineering
• Cryptography
• Web Exploitation
• Forensics
• OSINT
• Steganography
• Networking
• Tool documentation
• Tutorials
• Tips & Tricks

---

Installation

Prerequisites

• Windows 10 or later
• .NET 10 Runtime

Download

Download the latest release from the GitHub Releases page.

---

Development

Clone the Repository

git clone https://github.com/AaryanKhClasses/FlagForge.git
cd FlagForge

Frontend

cd frontend
npm install
npm run dev

Desktop Host

Open the host project in Visual Studio and run the application.

---

Contributing

Contributions are always welcome.

You can help by:

• Fixing bugs
• Improving documentation
• Adding new converter tools
• Implementing attachment analyzers
• Improving performance
• Adding new features
• Refactoring existing code

Please read CONTRIBUTING.md before opening a pull request.

---

Community

Please read our CODE_OF_CONDUCT.md before participating in discussions or contributing.

---

Security

If you discover a security vulnerability, please follow the instructions in SECURITY.md instead of opening a public issue.

---

Documentation

Detailed documentation is available in the frontend/docs/ directory and within the application.

Topics include:

• Getting Started
• Workspaces
• Challenges
• Attachment Tools
• Converter Tools
• CTF Techniques
• Tutorials
• Frequently Asked Questions

---

License

FlagForge is released under the MIT License.

See LICENSE for more information.

---

Acknowledgements

FlagForge is inspired by the workflows and utilities used throughout the CTF and cybersecurity community.

Special thanks to all contributors who help improve the project.

Code Owners:

Created and maintained by AaryanKhClasses and krish-acharya14

See CODEOWNERS for more information.

---

Made with ❤️ for the CTF community.