Flag Simulator

Click/tap here to expand/collapse this entire article (README)

Click/tap here to expand/collapse the logo section

Note: This flag is for vanity purposes only. It is not meant to signal support for anything. A new logo will be created in the future, although this project will have multiple logos (for different app icons)

Flag Simulator

Click/tap here to expand/collapse the title section

Flag Simulator is the ultimate vexillology software piece, which lets you do anything you would ever want to do with a flag.

It is intended to be an improvement over Krikienoid/FlagWaver

00.00 - Title
00.01 - Table of contents
00.02 - Read this article in a different language
00.03 - This repository
01.00 - Features
- 01.01 - Featured flags
- 01.02 - Flag physics
- 01.03 - Flag direction
- 01.04 - Wind direction
- 01.05 - Wind control
- 01.06 - Barometric pressure
- 01.07 - Different backgrounds
- 01.08 - Background videos
- 01.09 - Export
- 01.10 - Embed into a webpage
- 01.11 - Database of flags
- 01.12 - Upload custom flags
- 01.13 - Pennants
- 01.14 - Multiple flags
- 01.15 - Information on each flag
- 01.16 - FlagW file (waving flag data file)
- 01.17 - Flag burning
- 01.18 - Information on religious flags
- 01.19 - Flag tearing
- 01.20 - Half mast
- 01.21 - Waving/lowering
- 01.22 - Customizable flag poles
- 01.23 - Totem pole library
- 01.24 - Flag poles
- 01.25 - SVG, PNG, JPEG, GIF, TIFF, BMP, WEBP, NETP, ICO, GIF_C200, among other supported formats
- 01.26 - Various buttons
- 01.27 - Ability to send an army to take down the flag
- 01.28 - Offline functionality
- 01.29 - Rain and weather effects
- 01.30 - Play audio (national anthems, and anthem library)
- 01.31 - Simulate real weather (with weather services, and data files for weather events))
- 01.32 - Flag construction mode
- 01.33 - Flag folding
- 01.34 - Lighting, lighting modes
- 01.35 - Shine a light
- 01.36 - Flashlight (movable with cursor/finger)
- 01.37 - Customizable flashlight, different light colors, sizes, strengths of light
- 01.38 - Flag weaving
- 01.39 - Buy an actual flag (based on the one shown))
- 01.40 - FIAV flag
- 01.41 - Default flag
- 01.42 - Homepage
- 01.43 - Fire arrows
- 01.44 - Other items to throw
- 01.45 - Flag Emoji mode
- 01.46 - Flag Emoji import
- 01.47 - Flag search (search for a flag, Emojis also work as a search option)
- 01.48 - User interface skins
- 01.49 - Censorship modes for hate flags, Socialist/Communist flags, terrorist flags, etc
- 01.50 - Age rating
- 01.51 - Desktop application (with ports in Python, Java, C, and Rust)
- 01.52 - Web application (with ports in Ruby, JavaScript, PHP, and WebAssembly)
- 01.53 - Mobile application (with ports in Java, Kotlin, Swift, and C)
- 01.54 - Flag text and copy text from flag
- 01.55 - ASCII mode, with text color toggle
- 01.56 - Creating large flags (up to worlds largest)
- 01.57 - Size limit: whatever your system can handle (even 1,000,000m by 1,000,000m would be allowed) theoretical end at 9,223,372,036,854,775,807 (2^64) square pixels
- 01.58 - Flag code dictionary
- 01.59 - Flag creator: Your own flag (built-in editor) add description, colors, shapes, graphics, text mode, description, and flag code
- 01.60 - Color modes: monochrome, 4 bit, 5 bit, 6 bit, 7 bit, 8 bit, 12 bit, 16 bit, 24 bit, 32 bit, 48 bit, 64 bit
- 01.61 - Filters
- 01.62 - Slideshow mode
- 01.63 - Customize the area around the flag pole
- 01.64 - Multiple flag poles
- 01.65 - Flag pole size
- 01.66 - Flag pole material (metal, wood, etc.)
- 01.67 - Flag pole material download
- 01.68 - Dimensional modes: 2D, 3D, 4D
- 01.69 - Scissors, knives, and swords
- 01.70 - Acid raid effect
- 01.71 - Fun facts about Vexillology in the UI
- 01.72 - Accessories menu and the ability to import new ones (built-in: scissors, knives, swords, fire arrows, flashlight)
- 01.73 - Accessory files: a specialized data file for the project
- 01.74 - Transparency level
- 01.75 - Flag stamps
02.00 - Feedback
- 02.01 - Feedback from 2025, April
03.00 - Databases
- 03.01 - Flags Of The World (FOTW)
04.00 - Variants
- 04.01 - Web applications
- 04.02 - Desktop applications
- 04.03 - Mobile applications
- 04.04 - Snapcraft
05.00 - Current development target
06.00 - Repository plan
07.00 - LIBraries
08.00 - Installation
09.00 - Authors
10.00 - Credits
11.00 - Documentation
12.00 - Vexillological humor
13.00 - Concept from 2025.04.23
14.00 - Common tags
15.00 - File Info
16.00 - File History
17.00 - Footer
- 17.99 - EOF

Read this article in a different language

Click/tap here to expand/collapse the language switcher section

Sorted by: A-Z

Sorting options unavailable

Translations in languages other than English are machine translated and are not yet accurate. No errors have been fixed yet as of March 21st 2021. Please report translation errors here. Make sure to backup your correction with sources and guide me, as I don't know languages other than English well (I plan on getting a translator eventually) please cite wiktionary and other sources in your report. Failing to do so will result in a rejection of the correction being published.

Note: due to limitations with GitHub's interpretation of markdown (and pretty much every other web-based interpretation of markdown) clicking these links will redirect you to a separate file on a separate page that isn't the intended page. You will be redirected to the .github folder of this project, where the README translations are hosted.

Translations are currently done with Bing translate and DeepL. Support for Google Translate translations is coming to a close due to privacy concerns.

This repository

Click/tap here to expand/collapse the this repository section

View all files

📁️ Type 📄️	🔍️ Location 🔎️	ℹ️ Purpose ℹ️
📁️ Folder/directory	`/.github/`	GitHub repository configuration data
📁️ Folder/directory	`/.gitlab/`	GitLab repository configuration data
📁️ Folder/directory	`/Docs/`	For Flag Simulator documentation (redirect)
📁️ Folder/directory	`/LIB/`	For Flag Simulator libraries
📁️ Folder/directory	`/OldVersions/`	For archived old versions of files in this repository
📁️ Folder/directory	`/RepoData/`	For general repository data (metadata, description)
⚙️ Configuration file	`/.editorconfig`	Editor Config file
⚙️ Configuration file	`/.gitattributes`	Git Attributes file
⚙️ Configuration file	`/.gitignore`	Git Ignore file
🌐️ Webpage file	`/404.html`	404 page
🖼️ Image file	`/404.jpeg`	Image within 404 page
⬇️ Markdown file	`/404.md`	404 Jekyll page
👤️ Authors file	`/AUTHORS`	For displaying the authors of the project (plain text)
👤️ Authors file	`/AUTHORS.md`	For displaying the authors of the project (Markdown)
🤖️ Automation configuration file	`/AUTOMATE2001.yaml`	For configuring the AUTOMATE2001 software tool to automate tasks on this repository.
🤖️ Automation configuration file	`/AUTOMATE2001.yml`	For configuring the AUTOMATE2001 software tool to automate tasks on this repository (copy)
📋️ Repository list file	`/Flag-Simulator_REPOLIST.urll`	For displaying a list of all repositories in this project group.
🖼️ Image file	`/Flag-Simulator_PlaceholderLogo.svg`	A placeholder logo of a light blue flag
✒️ Citation file	`/CITATION.cff`	For enabling others to site this repository.
👥️ Contributions file	`/CONTRIBUTING.md`	For listing instructions on what can/cannot be contributed to this project.
💳️ License file	`/COPYINGL`	A license hub that explains license usage for this project.
👤️ Credits file	`/Credits`	For displaying the credits for the project (plain text)
👤️ Credits file	`/Credits.wiki`	For displaying the credits for the project (WikiText)
🖼️ Image file	`/DRM-free_label.en.svg`	An image file that emphasizes this projects Anti-DRM stance.
1️⃣️ Initial file	`/INITIAL_COMMIT.txt`	A file that was generated alongside the repository, and represents the first commit
🔺️ Installation file	`/INSTALL`	A file that gives instructions on how to install this project (plain text)
🔺️ Installation file	`/INSTALL.rst`	A file that gives instructions on how to install this project (reStructuredText)
🖥️ Linux Desktop entry file	`/K.desktop`	A Linux desktop entry file for this project, allowing it to be easily launched on UNIX-like systems
💳️ License file	`/LICENSE-GPL.py`	A GNU GPL3 license file for this project, with a Python file extension
💳️ License file	`/LICENSE-GPL.py3`	A GNU GPL3 license file for this project, with a Python file extension
💳️ License file	`/LICENSE-GPL.pyt`	A GNU GPL3 license file for this project, with a Python file extension
💳️ License file	`/LICENSE-GPL.txt`	A GNU GPL3 license file for this project, with the Plain Text file extension
💳️ License file	`/LICENSE-GPL.pyw`	A GNU GPL3 license file for this project, with a Python file extension
💳️ License file	`/LICENSE-GPL3.py`	A GNU GPL3 license file for this project, with a Python file extension
💳️ License file	`/LICENSE-GPL3.py3`	A GNU GPL3 license file for this project, with a Python file extension
💳️ License file	`/LICENSE-GPL3.pyt`	A GNU GPL3 license file for this project, with a Python file extension
💳️ License file	`/LICENSE-GPL3.txt`	A GNU GPL3 license file for this project, with the Plain Text file extension
💳️ License file	`/LICENSE-GPL3.pyw`	A GNU GPL3 license file for this project, with a Python file extension
💳️ License file	`/LICENSE.py`	A GNU GPL3 license file for this project, with a Python file extension
💳️ License file	`/LICENSE.py3`	A GNU GPL3 license file for this project, with a Python file extension
💳️ License file	`/LICENSE.pyt`	A GNU GPL3 license file for this project, with a Python file extension
💳️ License file	`/LICENSE.txt`	A GNU GPL3 license file for this project, with the Plain Text file extension
💳️ License file	`/LICENSE.pyw`	A GNU GPL3 license file for this project, with a Python file extension
⭐️ README file	`/README.md`	The main README.md file for this project, explaining how to use this project, and where to start.
📜️ Rootfiles list file	`/ROOTFILES.base`	The ROOTFILES base file for this project, listing all files and folders at the root of this repository.
🛡️ Security file	`/SECURITY.md`	For listing security information for this project.
🖼️ Image file	`/SponsorButton.png`	An image file that shows the GitHub sponsor button in this project.
1️⃣️ Initial file	`/Temolate-Python-Other.md`	An initial file, indicating which branch of the generation template was used to create this repository.
⚙️ Configuration file	`/_config.yml`	A configuration file for the Jekyll theme on this project.
🖥️ Windows Desktop entry file	`/desktop.ini`	The Windows desktop entry file for this project.
🔨️ Makefile	`/makefile.mk`	The main GNU Make build file for this project.
📃️ Pull request template	`/pull_request_template.md`	The pull request template file for this project, a template for starting a Git pull request.
📁️ Type 📄️	🔍️ Location 🔎️	ℹ️ Purpose ℹ️

Features

Click/tap here to expand/collapse the features section

Featured flags

Click/tap here to expand/collapse the featured flags section

Developed?

Featured flag (default flag upon starting program on certain days)

Examples:

May 5th: Flag of Mexico 🇲🇽️
August 24th: Flag of Ukraine 🇺🇦️

Flag physics

Click/tap here to expand/collapse the flag physics section

Developed?

Change the physics of the flag.

Flag direction
Wind direction
Wind control
Pressure

Flag direction

Click/tap here to expand/collapse the flag direction section

Developed?

Change the orientation in which the flag is hung.

Wind direction

Click/tap here to expand/collapse the wind direction section

Developed?

Change the direction that the wind is blowing in

Wind control

Click/tap here to expand/collapse the wind control section

Developed?

Change the speed, cycle, and gusts of the wind.

Barometric pressure

Click/tap here to expand/collapse the barometric pressure section

Developed?

Apply different degrees of barometric pressure to the flag environment.

Different backgrounds

Click/tap here to expand/collapse the different backgrounds section

Developed?

Change the background scenery from a collection of built-in images, or upload your own.

For desktop/mobile apps, a folder called /Backgrounds/Custom/Images/ will be created.

Background videos

Click/tap here to expand/collapse the background videos section

Developed?

Change the background scenery from a collection of built-in videos, or upload your own.

For desktop/mobile apps, a folder called /Backgrounds/Custom/Videos/ will be created.

Export

Click/tap here to expand/collapse the export section

Developed?

Export your flag to a separate file in either FlagW or another image format.

Embed into a webpage

Click/tap here to expand/collapse the embed into a webpage section

Developed?

Embed your custom waving flag into a webpage, program, or social media post.

Database of flags

Click/tap here to expand/collapse the database of flags section

Developed?

Choose from a database of flags, or upload your own. Built-in sources will contain all national flags, while expanions are available to include flags from FOTW (Flags Of The World)

Upload custom flags

Click/tap here to expand/collapse the upload custom flags section

Developed?

Upload a custom image to use as a flag.

Pennants

Click/tap here to expand/collapse the pennants section

Developed?

Fly a pennant in place of a flag.

Multiple flags

Click/tap here to expand/collapse the multiple flags section

Developed?

Fly multiple flags at once, either on the same pole, or on separate poles.

Information on each flag

Click/tap here to expand/collapse the information on each flag section

Developed?

Get information on each flag from a built-in database, and learn the meaning of each flag, its history, and its guidelines.

FlagW file (waving flag data file)

Click/tap here to expand/collapse the FlagW file section

Developed?

A custom file format for displaying a waving flag.

File type
`*.flagw`

The file can contain flag poles, flags, and description data individually, or altogether.

Flag burning

Click/tap here to expand/collapse the Flag burning section

Developed?

A built-in animation that adds a burning animation to flags. Users can choose whether it burns permanently without causing damage, or if burns the flag, and even if it burns the pole.

Information on religious flags

Click/tap here to expand/collapse the Information on religious flags section

Developed?

Built-in information on religious flags, and their guidelines. For example, the Flag of Saudi Arabia cannot be flown at half-mast, as it contains a religious symbol on it (the shahada) and is considered disrespectful to Islam to put this symbol down.

Flag tearing

Click/tap here to expand/collapse the flag tearing section

Developed?

A built-in animation that lets you tear pieces of the flag. Choose the type of material first.

Cloth
Paper
Vinyl
ETC

Half mast

Click/tap here to expand/collapse the half mast section

Developed?

Lower the flag to half-mast to indicate mourning.

Raising/lowering

Click/tap here to expand/collapse the raising/lowering section

Developed?

Raise/lower the flag.

Customizable flag poles

Click/tap here to expand/collapse the customizable flag poles section

Developed?

Customize the graphics of the flag pole, its material, and its appearance.

Totem pole library

Click/tap here to expand/collapse the totem pole library section

Developed?

Customize the flag pole by giving it a Totem Pole style. A Totem Pole graphics library will be built-in.

Flag poles

Click/tap here to expand/collapse the flag poles section

Developed?

Change between flag pole mode, and flag lying on the ground mode.

SVG, PNG, JPEG, GIF, TIFF, BMP, WEBP, NETP, ICO, GIF_C200, among other supported formats

Click/tap here to expand/collapse the image file format support section

Developed?

Allows for importing and exporting flags through various file formats.

Various buttons

Click/tap here to expand/collapse the various buttons section

Developed?

A set of buttons on the UI that do various things, such as change dimensions, open up flag pole or flag libraries, open up accessories, change the background, and more.

Ability to send an army to take down the flag

Click/tap here to expand/collapse the ability to send an army to take down the flag section

Developed?

A button that lets the user summon a custom army to try and take down the flag. Users can add a garrison to their flag to make it a fight, or just have the enemy come and take it down. The user can choose which flag the enemy flies in its place, and what the enemy does with the flag.

Offline functionality

Click/tap here to expand/collapse the offline functionality section

Developed?

Allow the program to work completely offline.

Rain and weather effects

Click/tap here to expand/collapse the rain and weather effects section

Developed?

Display various weather types, and allow the flag to be simulated or not alongside them, as a decorative piece, or as a functional piece. Choose whether the flag is damaged or not from this.

Rain effects
Hail effects
Lightning effects
Snow effects

Play audio (national anthems, and anthem library)

Click/tap here to expand/collapse the play audio section

Developed?

Play custom audio for the flag, or use a built-in library, mostly consisting of background music and anthems.

Anthem library
Ambient library
Sound effect library

Choose to play flag sound effects

Simulate real weather (with weather services, and data files for weather events)

Click/tap here to expand/collapse the simulate real weather section

Developed?

Simulate weather on your flag with weather services, and data files from current, past, and future weather events (unknown file format)

Flag construction mode

Click/tap here to expand/collapse the flag construction mode section

Developed?

Go into flag construction mode, and see flag construction sheets, and how they go into making a flag.

Flag folding

Click/tap here to expand/collapse the flag folding section

Developed?

Fold up your flag, and unfold it.

Lighting, lighting modes

Click/tap here to expand/collapse the lighting, lighting modes section

Developed?

Adjust the lighting around your flag, and change the lighting mode.

Shine a light

Click/tap here to expand/collapse the shine a light section

Developed?

Shine a light on your flag with a searchlight.

Flashlight (movable with cursor/finger)

Click/tap here to expand/collapse the flashlight section

Developed?

A custom accessory, which gives the user a flashlight, which is movable with a cursor or a finger, which will position the light onto the flag. Gesture support coming soon.

Customizable flashlight, different light colors, sizes, strengths of light

Click/tap here to expand/collapse the customizable flashlight section

Developed?

Customize the flash light accessory by giving it different colored lights, different sizes (and therefore different amounts of light) along with different strengths of light.

Flag weaving

Click/tap here to expand/collapse the flag weaving section

Not to be confused with flag waving

Developed?

Design and weave a flag within the program, through flag construction mode.

Buy an actual flag (based on the one shown)

Click/tap here to expand/collapse the buy an actual flag section

Developed?

A third-party feature, which allows the user to go out and buy a flag either from the flag library, or through a custom upload. Through the flag library, a catalog of flag websites will be shown that can allow the user to buy a similar flag. The mechanics for buying a custom flag are not yet known. Both options result in a physical flag being delivered to the user.

FIAV flag

Click/tap here to expand/collapse the FIAV flag section

Developed?

When the option to not choose a flag based on what day of the year it is is not checked, or is unavailable due to time settings, the FIAV flag (International Federation of Vexillological Associations) can be chosen as a default flag to show.

Default flag

Click/tap here to expand/collapse the default flag section

Developed?

Change the default flag on the homepage to a different flag, and choose whether it appears each time. Include an option that lets the last flag shown be displayed.

Homepage

Click/tap here to expand/collapse the homepage section

Developed?

A flag homepage for the program.

Fire arrows

Click/tap here to expand/collapse the fire arrows section

Developed?

An accessory that allows fire arrows to be shot at the flag. Similar to the flag burning effect, users can choose whether the fire actually does damage, and also can choose if the arrow can pierce the flag or not.

Other items to throw

Click/tap here to expand/collapse the other items to throw section

Developed?

More accessories for different items to throw at the flag.

Flag Emoji mode

Click/tap here to expand/collapse the flag Emoji mode section

Developed?

Enable flag Emoji mode to show flag Emojis as waving flags.

Flag Emoji import

Click/tap here to expand/collapse the flag Emoji import section

Developed?

Import different flag Emoji styles, and wave them as flags.

Flag search (search for a flag, Emojis also work as a search option)

Click/tap here to expand/collapse the flag search section

Developed?

Search for a flag through a text search within the program, or with an Emoji, which will also work as a search option. Regional Indicator Letters are also a valid search query.

User interface skins

Click/tap here to expand/collapse the user interface skins section

Developed?

Add a different user interface to the program by choosing a different skin, stored as a data file.

Censorship modes for hate flags, Socialist/Communist flags, terrorist flags, etc

Click/tap here to expand/collapse the censorship modes section

Developed?

Censorship settings to enable/disable flags, such as flags of hate groups, flags of Socialist/Communist groups, flags associated with terrorism, flags associated with religion, or another reason.

Age rating

Click/tap here to expand/collapse the age rating section

Developed?

Choose an age rating for this project, based on the Open Media Rating System

Desktop application (with ports in Python, Java, C, and Rust)

Click/tap here to expand/collapse the desktop application section

Developed?

Develop desktop applications for this project. See below

Web application (with ports in Ruby, JavaScript, PHP, and WebAssembly)

Click/tap here to expand/collapse the web application section

Developed?

Develop web applications for this project. See below

Mobile application (with ports in Java, Kotlin, Swift, and C)

Click/tap here to expand/collapse the mobile application section

Developed?

Develop mobile applications for this project. See below

Flag text and copy text from flag

Click/tap here to expand/collapse the flag text and copy text from flag section

Developed?

Copy the text from the flag, and copy other pieces of text related to the flag.

ASCII mode, with text color toggle

Click/tap here to expand/collapse the ASCII mode section

Developed?

Enter ASCII mode, to have the flag be shown purely with text, along with a toggle to enable different text colors. Also export as ASCIInema video files.

Creating large flags (up to worlds largest)

Click/tap here to expand/collapse the creating large flags section

Developed?

Create large flag graphics via the flagw file format, and the flag displayer. See below: size limit.

Size limit: whatever your system can handle (even 1,000,000m by 1,000,000m would be allowed) theoretical end at 9,223,372,036,854,775,807 (2^64) square pixels

Click/tap here to expand/collapse the size limit section

Developed?

Create flags from either 1x1 pixels up to 9,223,372,036,854,775,807 square pixels (? dimensions) the default setting is defined in the image file chosen.

Flag code dictionary

Click/tap here to expand/collapse the Flag code dictionary section

Developed?

View a dictionary that shows the flag code for various flags.

Flag creator: Your own flag (built-in editor) add description, colors, shapes, graphics, text mode, description, and flag code

Click/tap here to expand/collapse the Flag creator section

Developed?

Enter the flag creator, where you can create your own flag, with a built-in vector and Bitmap graphics editor. Therr is a toggle between vector and bitmap. A description can be added, colors can be customized, shapes and other graphics can be appended, text can be entered, a different font can be chosen, the flag can be given a description, and the flag can even be given its own flag code.

Color modes: monochrome, 4 bit, 5 bit, 6 bit, 7 bit, 8 bit, 12 bit, 16 bit, 24 bit, 32 bit, 48 bit, 64 bit

Click/tap here to expand/collapse the Color modes section

Developed?

Change the color mode of the program, or just the flag. Available option:

Filters

Click/tap here to expand/collapse the filters section

Developed?

Choose between different filters to display your flag alongside.

Confetti filter
Other

Slideshow mode

Click/tap here to expand/collapse the slideshow mode section

Developed?

Enter slideshow mode, and showcase a slideshow of flags, flag backgrounds, or both.

Customize the area around the flag pole

Click/tap here to expand/collapse the customize the area around the flag pole section

Developed?

Customize the area around the flag pole by adding different objects (such as accessories) and other graphics around the base.

Multiple flag poles

Click/tap here to expand/collapse the multiple flag poles section

Developed?

Add support for multiple flag poles at once.

Flag pole size

Click/tap here to expand/collapse the flag pole size section

Developed?

Change the size of the flag pole, both perimeter, width, and height

Flag pole material (metal, wood, etc.)

Click/tap here to expand/collapse the flag pole material section

Developed?

Change the material of the flag pole, to a material such as metal, wood, plastic, stone, or something else.

Flag pole material download

Click/tap here to expand/collapse the flag pole material download section

Developed?

Download the material file for the flag pole.

Dimensional modes: 2D, 3D, 4D

Click/tap here to expand/collapse the Dimensional modes section

Developed?

Change the dimensions of the program with a toggle to either 2D, 3D or 4D

Scissors, knives, and swords

Click/tap here to expand/collapse the Scissors, knives, and swords section

Developed?

Use scissors, knives, and swords as accessories to attack the flag(s)

Acid raid effect

Click/tap here to expand/collapse the Acid rain effect section

Developed?

Enable the acid rain effect to have acid rain come down on your flag(s).

Fun facts about Vexillology in the UI

Click/tap here to expand/collapse the fun facts about vexillology section

Developed?

Showcase fun facts about vexillology within the programs user interface.

Accessories menu and the ability to import new ones (built-in: scissors, knives, swords, fire arrows, flashlight)

Click/tap here to expand/collapse the accessories menu section

Developed?

Enable the accessories menu to use different accessories, and to import new accessories for use in the program.

Built-in accessories include:

Accessory files: a specialized data file for the project

Click/tap here to expand/collapse the accessory files section

Developed?

Use accessory files to enable custom effects into the program, and use different accessories besides the 5 built-in ones.

A gun accessory will be included separately, and will not be built-in, to keep the main program more friendly to a wider audience (although the flag of Mozambique will still be built in, despite having a gun on it)

Transparency level

Click/tap here to expand/collapse the transparency level section

Developed?

Change the transparency/opacity of the flag, the flagpole, or both.

Flag stamps

Click/tap here to expand/collapse the flag stamps section

Developed?

Suggested by @MemeWallaWalla

A work in progress feature that involves flag stamps.

End of feature listing.

Feedback

Click/tap here to expand/collapse the Feedback section

Feedback for this project.

Feedback from 2025, April

Click/tap here to expand/collapse the feedback from 2025, April section

Reminder that this project suits a limited audience

Feature idea: Flag stamps

Reference:

Early preview documents used to gather feedback (from 2025, April 28th to 2025, May 4th)

Send feedback

End of feedback

Databases

Click/tap here to expand/collapse the Databases section

Custom databases that can be used within the Flag Simulator project.

Flags Of The World (FOTW)

Click/tap here to expand/collapse the Flags of the World (FOTW) database section

Repository listing:

End of database listing.

Variants

Click/tap here to expand/collapse the Variants section

See: Flag-Simulator_REPOLIST.urll

Web Applications

Click/tap here to expand/collapse the Web Applications section

Desktop Applications

Click/tap here to expand/collapse Desktop Web Applications section

Mobile Applications

Click/tap here to expand/collapse the Mobile Applications section

Snapcraft

Click/tap here to expand/collapse the Snapcraft section

Will there be a Snapcraft version?

Not officially. I won't create one, as I have grown to dislike snapcraft a whole lot since I began using Ubuntu back in 2020, but I wouldn't oppose a community snap build if it was developed by someone else. Snapcraft may be convenient for portability between different Linux distributions, but it goes against free software standards, as it is proprietary, doesn't give the user a choice on things like updates, and is additionally generally more unstable than a normal Debian or RPM package.

Current development target

Click/tap here to expand/collapse the Current development target section

Current development target

The current targets for development are Debian, Ubuntu, and Raspberry Pi OS. Other platforms will also be tested, but will be lower priority for now.

Desktop and Mobile application support

🖥️ OS	🎯️ Target?
Windows 12 (beta)	❌️
Windows 11	❌️
Windows 10	❌️
MacOS	❌️
iOS 15 and up	❓️
Android 10 and up	❓️
ChromeOS	❌️
FreeBSD	❌️
NetBSD	❌️
OpenBSD	❌️
Dragonfly BSD	❌️
Debian 7	✅️
Debian 8	✅️
Debian 9	✅️
Ubuntu 16.04 and up	✅️
Kubuntu 16.04 and up	❓️
Lubuntu 16.04 and up	❓️
Xubuntu 16.04 and up	❓️
PureOS	❓️
Fedora 31 and up	❌️
Red Hat Linux	❌️
Gentoo Linux	❌️
Arch Linux	❌️
Raspberry Pi OS	✅️
🖥️ OS	🎯️ Target?

Legend
❌️
❓️
✅️
Legend

Web application support

🚂️ Engine	🎯️ Target?
Gecko	✅️
Chromium	❌️
Trident	❌️
Presto	❌️
Goanna	✅️

🌐️ Browser	🎯️ Target?
Mozilla Firefox	✅️
Google Chrome	❌️
Google Chromium	❌️
Safari	❌️
Opera	❌️
Brave	❌️
DuckDuckGo	✅️
Microsoft Edge	❌️
Microsoft Internet Explorer	❌️
Samsung Internet	❌️
Pale Moon	✅️
Vivaldi	❌️
LadyBird	❓️
Waterfox	✅️
Bliss Browser	❓️
Dillo	❌️
Line Mode Browser	❌️
Tor	❓️
iCab	❌️
Basilisk	❌️
SeaMonkey	❌️
LibreWolf	❌️
K-Meleon	❌️

Legend
❌️
❓️
✅️
Legend

Repository plan

Click/tap here to expand/collapse the repository plan section

Repository plan

The core Flag Simulator repository will contain some of the key media resources (such as logos, some of the essential flags, icons, wallpapers) while the database repositories will hold the rest. Desktop Applications, Mobile Applications, and Web Applications will be programmed to use these resources (maybe as submodules)

Libraries

Click/tap here to expand/collapse the LIBraries section

Internal LIBraries

Click/tap here to expand/collapse the Internal LIBraries section

Third-party LIBraries

Click/tap here to expand/collapse the Third-party LIBraries section

None decided on yet

End of LIBrary listing.

Installation

Click/tap here to expand/collapse the Installation section

See: INSTALL.rst [OUTDATED, as of 2025, Wednesday, May 7th)

Credits

Click/tap here to expand/collapse the Credits section

See: CREDITS.wiki [OUTDATED, as of 2025, Wednesday, May 7th)

Authors

Click/tap here to expand/collapse the Authors section

See: AUTHORS.md [OUTDATED, as of 2025, Wednesday, May 7th)

Documentation

Click/tap here to expand/collapse the Documentation section

Documentation is housed in a separate repository.

Click/tap here to go to the Flag Simulator documentation repository

Vexillological humor

Cannot directly link to these sources, due to ethical issues (DRM)

Reddit: r/vexillologycirclejerk
Unknown/various: The Big Bang Theory: Fun with Flags
Suggest another

Concept 2025.04.23

Click/tap here to expand/collapse the Concept 2025.04.23 section

2025.04.23
Flag-Simulator
Flag-Simulator_Docs

Flag-Simulator_WebApp_JavaScript ✔️
Flag-Simulator_WebApp_JavaScript_Docs ✔️
Flag-Simulator_WebApp_Ruby ✔️
Flag-Simulator_WebApp_Ruby_Docs ✔️
Flag-Simulator_WebApp_PHP ✔️
Flag-Simulator_WebApp_PHP_Docs ✔️
Flag-Simulator_WebApp_WebAssembly ✔️
Flag-Simulator_WebApp_WebAssembly_Docs ✔️
Flag-Simulator_DesktopApp_Python ✔️
Flag-Simulator_DesktopApp_Python_Docs ✔️
Flag-Simulator_DesktopApp_Java ✔️
Flag-Simulator_DesktopApp_Java_Docs ✔️
Flag-Simulator_DesktopApp_C ✔️
Flag-Simulator_DesktopApp_C_Docs ✔️
Flag-Simulator_DesktopApp_Rust ✔️
Flag-Simulator_DesktopApp_Rust_Docs ✔️
Flag-Simulator_MobileApp_Java ✔️
Flag-Simulator_MobileApp_Java_Docs ✔️
Flag-Simulator_MobileApp_Kotlin ✔️
Flag-Simulator_MobileApp_Kotlin_Docs ✔️
Flag-Simulator_MobileApp_Swift ✔️
Flag-Simulator_MobileApp_Swift_Docs ✔️
Flag-Simulator_MobileApp_C ✔️
Flag-Simulator_MobileApp_C_Docs ✔️

Featured flag (default flag upon starting program on certain days)

May 5th: Flag of Mexico
August 24th: Flag of Ukraine

Improvement over Krikenoid/FlagWaver

Features

Flag physics
Flag direction
Wind direction
Wind control
Different backgrounds
Background videos
Export
Embed into a webpage
Database of flags
Upload custom flags
Pennants
Information on each flag
FlagW file (waving flag data file)
Flag burning
Information on religious flags
Flag tearing
Half mast
Raising/lowering
Customizable flag poles
Flag poles
SVG, PNG, JPEG, GIF, TIFF, BMP, WEBP, NETP, ICO, GIF_C200, among other supported formats
Various buttons
Ability to send an army to take down the flag
Offline functionality
Rain and weather effects
Play audio (national anthems, and anthem library)
Simulate real weather (with weather services, and data files for weather events)
Flag construction mode
Flag folding
Lighting, lighting modes
Shine a light
Flashlight (movable with cursor/finger)
Customizable flashlight, different light colors, sizes, strengths of light
Flag weaving
Buy an actual flag (based on the one shown)
VIAF flag
Default flag
Homepage
Fire arrows
Other items to throw
Flag Emoji mode
Flag Emoji import
Flag search (search for a flag, Emojis also work as a search option)
User interface skins
Censorship modes for hate flags, Socialist/Communist flags, terrorist flags, etc
Age rating
Desktop application (with ports in Python, Java, C, and Rust)
Web application (with ports in Ruby, JavaScript, PHP, and WebAssembly)
Mobile application (with ports in Java, Kotlin, Swift, and C)
Flag text and copy text from flag
ASCII mode, with text color toggle
Creating large flags (up to worlds largest)
Size limit: whatever your system can handle (even 1,000,000m by 1,000,000m would be allowed) theoretical end at 9,223,372,036,854,775,807 (2^64) square pixels
Flag code dictionary
Flag creator: Your own flag (built-in editor) add description, colors, shapes, graphics, text mode, description, and flag code
Color modes: monochrome, 4 bit, 5 bit, 6 bit, 7 bit, 8 bit, 12 bit, 16 bit, 24 bit, 32 bit, 48 bit, 64 bit
Filters
Slideshow mode
Customize the area around the flag pole
Multiple flag poles
Flag pole size
Flag pole material (metal, wood, etc.)
Flag pole material download
Dimensional modes: 2D, 3D, 4D
Scissors, knives, and swords
Acid raid effect
Fun facts about Vexillology in the UI
Accessories menu and the ability to import new ones (built-in: scissors, knives, swords, fire arrows, flashlight)
Accessory files: a specialized data file for the project
Gun accessory will be included separately, and will not be built-in, to keep the main program more friendly to a wider audience (although the flag of Mozambique will still be built in, despite having a gun on it)

Flagwaver feature 2025.04.27
Transparency level

---

Feedback on Flag Simulator (2025, April 28th)

Reminder that this project suits a limited audience

Flag stamps

Trying to be careful with naming forks, due to usernames. I always check the spelling of the name, and will usually do all lowercase or uppercase, if I can’t determine where a first name, middle name, or last name start or end, or if one exists. I do the same for the repository name as well

Flag simulator 2025.04.28

Totem pole library

---

Flag Simulator 2025.04.30

Flag-Simulator_DB_FOTW ✔️
Flag-Simulator_DB_FOTW_Docs ✔️

---

Flag simulator 2025.05.01 (imported 2025.05.02)

Feature checklist in README

Common tags

Click/tap here to expand/collapse this section

Common tags for this project.

File info

Click/tap here to expand/collapse this section

File type: Markdown document (*.md *.mkd *.mdown *.markdown)
File version: 5 (2025, Friday, May 9th at 06:32 pm PST)
Line count (including blank lines and compiler line): 01,768
Word count: 11,025
Character count (with spaces): 074,943 characters
Character count (without spaces) 064,435 characters
Current article language: English (EN_USA) for main article / Markdown (CommonMark) / HTML (HTML 5.3)
Encoding: UTF-8 (Emoji 12.0 or higher recommended)
All times are UTC-7 (PDT/Pacific Time) (Please also account for DST (Daylight Savings Time) for older/newer entries up until it is abolished/no longer followed)

Note On 2022, Sunday, March 13th at 2:00 am PST, the time jumped ahead 1 hour to 3:00 am.

Note You may need special rendering support for the <details> HTML tag being used in this document

View this segment in a separate file

File history

Click/tap here to expand/collapse the file history section

Version 1 (2025, Monday, May 5th at 09:55 pm PST)

Click/tap here to expand/collapse the file history section entry for version 1

Note: This is the first version.

Changes:

Version 2 (2025, Tuesday, May 6th at 05:40 pm PST)

Click/tap here to expand/collapse the file history section entry for version 2

Note: This is the second version.

Changes:

Updated information on development targets
Updated the File info section
Added the File History section
Added the Snapcraft section
Added the Current development targets section
Added the Repository plan section
Added dropdown support to all sections
Added the Footer section
No other changes in version 2

Version 3 (2025, Wednesday, May 7th at 06:38 pm PST)

Click/tap here to expand/collapse the file history section entry for version 3

Note: This is the third version.

Changes:

Updated the File info section
Updated the File History section
Added the Documentation section
Added the LIBraries section
Added the Installation section
Added the Credits section
Added the Authors section
Updated the current development target section
No other changes in version 3

Version 4 (2025, Thursday, May 8th at 07:34 pm PST)

Click/tap here to expand/collapse the file history section entry for version 4

Note: This is the fourth version.

Changes:

Updated the File info section
Updated the File History section
Added the Table of contents section
Added the Language switcher section
Added the This repository section
Added the Common tags section
Added the Footer section
No other changes in version 4

Version 5 (2025, Friday, May 9th at 06:32 pm PST)

Click/tap here to expand/collapse the file history section entry for version 5

Note: This is the fifth version, and the final consecutive version for now.

Changes:

Updated the File info section
Updated the File History section
Updated the Table of contents section
- Added remaining feature sections
- Added link to Vexillological humor section
Added the Vexillological humor section
No other changes in version 5

End of file history section.

Footer

You have reached the bottom of this page.

EOF

End of article.

Name		Name	Last commit message	Last commit date
Latest commit History 65 Commits
.github		.github
.gitlab		.gitlab
Docs		Docs
LIB		LIB
OldVersions		OldVersions
RepoData/Description/GitHub		RepoData/Description/GitHub
.editorconfig		.editorconfig
.gitattributes		.gitattributes
.gitignore		.gitignore
404.html		404.html
404.jpeg		404.jpeg
404.md		404.md
AUTHORS		AUTHORS
AUTHORS.md		AUTHORS.md
AUTOMATE2001.yaml		AUTOMATE2001.yaml
AUTOMATE2001.yml		AUTOMATE2001.yml
CONTRIBUTING.md		CONTRIBUTING.md
COPYINGL		COPYINGL
CREDITS		CREDITS
CREDITS.wiki		CREDITS.wiki
DRM-free_label.en.svg		DRM-free_label.en.svg
Flag-Simulator_PlaceholderLogo.svg		Flag-Simulator_PlaceholderLogo.svg
Flag-Simulator_REPOLIST.urll		Flag-Simulator_REPOLIST.urll
INITIAL_COMMIT.txt		INITIAL_COMMIT.txt
INSTALL		INSTALL
INSTALL.rst		INSTALL.rst
K.desktop		K.desktop
LICENSE-GPL.py		LICENSE-GPL.py
LICENSE-GPL.py3		LICENSE-GPL.py3
LICENSE-GPL.pyt		LICENSE-GPL.pyt
LICENSE-GPL.pyw		LICENSE-GPL.pyw
LICENSE-GPL.txt		LICENSE-GPL.txt
LICENSE-GPL3.py		LICENSE-GPL3.py
LICENSE-GPL3.py3		LICENSE-GPL3.py3
LICENSE-GPL3.pyt		LICENSE-GPL3.pyt
LICENSE-GPL3.pyw		LICENSE-GPL3.pyw
LICENSE-GPL3.txt		LICENSE-GPL3.txt
LICENSE.py		LICENSE.py
LICENSE.py3		LICENSE.py3
LICENSE.pyt		LICENSE.pyt
LICENSE.pyw		LICENSE.pyw
LICENSE.txt		LICENSE.txt
README.md		README.md
ROOTFILES.base		ROOTFILES.base
SECURITY.md		SECURITY.md
SponsorButton.png		SponsorButton.png
Template-Python-Other		Template-Python-Other
_config.yml		_config.yml
desktop.ini		desktop.ini
gitlab-ci.yml		gitlab-ci.yml
makefile.mk		makefile.mk
pull_request_template.md		pull_request_template.md

License

Licenses found

seanpm2001/Flag-Simulator

Folders and files

Latest commit

History

Repository files navigation

Flag Simulator

Table of Contents

Read this article in a different language

This repository

Features

Featured flags

Flag physics

Flag direction

Wind direction

Wind control

Barometric pressure

Different backgrounds

Background videos

Export

Embed into a webpage

Database of flags

Upload custom flags

Pennants

Multiple flags

Information on each flag

FlagW file (waving flag data file)

Flag burning

Information on religious flags

Flag tearing

Half mast

Raising/lowering

Customizable flag poles

Totem pole library

Flag poles

SVG, PNG, JPEG, GIF, TIFF, BMP, WEBP, NETP, ICO, GIF_C200, among other supported formats

Various buttons

Ability to send an army to take down the flag

Offline functionality

Rain and weather effects

Play audio (national anthems, and anthem library)

Simulate real weather (with weather services, and data files for weather events)

Flag construction mode

Flag folding

Lighting, lighting modes

Shine a light

Flashlight (movable with cursor/finger)

Customizable flashlight, different light colors, sizes, strengths of light

Flag weaving

Buy an actual flag (based on the one shown)

FIAV flag

Default flag

Homepage

Fire arrows

Other items to throw

Flag Emoji mode

Flag Emoji import

Flag search (search for a flag, Emojis also work as a search option)

User interface skins

Censorship modes for hate flags, Socialist/Communist flags, terrorist flags, etc

Age rating

Desktop application (with ports in Python, Java, C, and Rust)

Web application (with ports in Ruby, JavaScript, PHP, and WebAssembly)

Mobile application (with ports in Java, Kotlin, Swift, and C)

Flag text and copy text from flag

ASCII mode, with text color toggle

Creating large flags (up to worlds largest)

Size limit: whatever your system can handle (even 1,000,000m by 1,000,000m would be allowed) theoretical end at 9,223,372,036,854,775,807 (2^64) square pixels

Flag code dictionary

Flag creator: Your own flag (built-in editor) add description, colors, shapes, graphics, text mode, description, and flag code

Color modes: monochrome, 4 bit, 5 bit, 6 bit, 7 bit, 8 bit, 12 bit, 16 bit, 24 bit, 32 bit, 48 bit, 64 bit

Filters

Slideshow mode

Customize the area around the flag pole

Multiple flag poles

Flag pole size

Flag pole material (metal, wood, etc.)

Flag pole material download

Dimensional modes: 2D, 3D, 4D

Packages