Skip to content

AaryanKhClasses/FlagForge

Repository files navigation

FlagForge

FlagForge Logo

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.

About

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

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Contributors

Languages