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)
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
- 02.00 - Feedback
- 03.00 - Databases
- 04.00 - Variants
- 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
Click/tap here to expand/collapse the language switcher section
Sorted by: A-Z
( af Afrikaans Afrikaans | sq Shqiptare Albanian | am አማርኛ Amharic | ar عربى Arabic | hy հայերեն Armenian | az Azərbaycan dili Azerbaijani | eu Euskara Basque | be Беларуская Belarusian | bn বাংলা Bengali | bs Bosanski Bosnian | bg български Bulgarian | ca Català Catalan | ceb Sugbuanon Cebuano | ny Chichewa Chichewa | zh-CN 简体中文 Chinese (Simplified) | zh-t 中國傳統的） Chinese (Traditional) | co Corsu Corsican | hr Hrvatski Croatian | cs čeština Czech | da dansk Danish | nl Nederlands Dutch | en-us English English | EO Esperanto Esperanto | et Eestlane Estonian | tl Pilipino Filipino | fi Suomalainen Finnish | fr français French | fy Frysk Frisian | gl Galego Galician | ka ქართველი Georgian | de Deutsch German | el Ελληνικά Greek | gu ગુજરાતી Gujarati | ht Kreyòl ayisyen Haitian Creole | ha Hausa Hausa | haw Ōlelo Hawaiʻi Hawaiian | he עִברִית Hebrew | hi हिन्दी Hindi | hmn Hmong Hmong | hu Magyar Hungarian | is Íslenska Icelandic | ig Igbo Igbo | id bahasa Indonesia Icelandic | ga Gaeilge Irish | it Italiana/Italiano | ja 日本語 Japanese | jw Wong jawa Javanese | kn ಕನ್ನಡ Kannada | kk Қазақ Kazakh | km ខ្មែរ Khmer | rw Kinyarwanda Kinyarwanda | ko-south 韓國語 Korean (South) | ko-north 문화어 Korean (North) (NOT YET TRANSLATED) | ku Kurdî Kurdish (Kurmanji) | ky Кыргызча Kyrgyz | lo ລາວ Lao | la Latine Latin | lt Lietuvis Lithuanian | lb Lëtzebuergesch Luxembourgish | mk Македонски Macedonian | mg Malagasy Malagasy | ms Bahasa Melayu Malay | ml മലയാളം Malayalam | mt Malti Maltese | mi Maori Maori | mr मराठी Marathi | mn Монгол Mongolian | my မြန်မာ Myanmar (Burmese) | ne नेपाली Nepali | no norsk Norwegian | or ଓଡିଆ (ଓଡିଆ) Odia (Oriya) | ps پښتو Pashto | fa فارسی |Persian pl polski Polish | pt português Portuguese | pa ਪੰਜਾਬੀ Punjabi | No languages available that start with the letter Q | ro Română Romanian | ru русский Russian | sm Faasamoa Samoan | gd Gàidhlig na h-Alba Scots Gaelic | sr Српски Serbian | st Sesotho Sesotho | sn Shona Shona | sd سنڌي Sindhi | si සිංහල Sinhala | sk Slovák Slovak | sl Slovenščina Slovenian | so Soomaali Somali | [es en español Spanish | su Sundanis Sundanese | sw Kiswahili Swahili | sv Svenska Swedish | tg Тоҷикӣ Tajik | ta தமிழ் Tamil | tt Татар Tatar | te తెలుగు Telugu | th ไทย Thai | tr Türk Turkish | tk Türkmenler Turkmen | uk Український Ukrainian | ur اردو Urdu | ug ئۇيغۇر Uyghur | uz O'zbek Uzbek | vi Tiếng Việt Vietnamese | cy Cymraeg Welsh | xh isiXhosa Xhosa | yi יידיש Yiddish | yo Yoruba Yoruba | zu Zulu Zulu ) Available in 110 languages (108 when not counting English and North Korean, as North Korean has not been translated yet Read about it here)
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.
Click/tap here to expand/collapse the this repository section
| 📁️ 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 ℹ️ |
Click/tap here to expand/collapse the features section
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 🇺🇦️
Click/tap here to expand/collapse the flag physics section
- Developed?
Change the physics of the flag.
- Flag direction
- Wind direction
- Wind control
- Pressure
Click/tap here to expand/collapse the flag direction section
- Developed?
Change the orientation in which the flag is hung.
Click/tap here to expand/collapse the wind direction section
- Developed?
Change the direction that the wind is blowing in
Click/tap here to expand/collapse the wind control section
- Developed?
Change the speed, cycle, and gusts of the wind.
Click/tap here to expand/collapse the barometric pressure section
- Developed?
Apply different degrees of barometric pressure to the flag environment.
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.
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.
Click/tap here to expand/collapse the export section
- Developed?
Export your flag to a separate file in either FlagW or another image format.
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.
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)
Click/tap here to expand/collapse the upload custom flags section
- Developed?
Upload a custom image to use as a flag.
Click/tap here to expand/collapse the pennants section
- Developed?
Fly a pennant in place of a flag.
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.
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.
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.
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.
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.
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
Click/tap here to expand/collapse the half mast section
- Developed?
Lower the flag to half-mast to indicate mourning.
Click/tap here to expand/collapse the raising/lowering section
- Developed?
Raise/lower the flag.
Click/tap here to expand/collapse the customizable flag poles section
- Developed?
Customize the graphics of the flag pole, its material, and its appearance.
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.
Click/tap here to expand/collapse the flag poles section
- Developed?
Change between flag pole mode, and flag lying on the ground mode.
Click/tap here to expand/collapse the image file format support section
- Developed?
Allows for importing and exporting flags through various file formats.
- Support for importing/exporting flags as SVG
- Support for importing/exporting flags as SVG (animated)
- Support for importing/exporting flags as PNG
- Support for importing/exporting flags as PNG (animated)
- Support for importing/exporting flags as JPEG
- Support for importing/exporting flags as GIF
- Support for importing/exporting flags as GIF (animated)
- Support for importing/exporting flags as TIFF
- Support for importing/exporting flags as BMP
- Support for importing/exporting flags as WEBP
- Support for importing/exporting flags as NETP
- Support for importing/exporting flags as ICO
- Support for importing/exporting flags as GIF_C200
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.
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.
Click/tap here to expand/collapse the offline functionality section
- Developed?
Allow the program to work completely offline.
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
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
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)
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.
Click/tap here to expand/collapse the flag folding section
- Developed?
Fold up your flag, and unfold it.
Click/tap here to expand/collapse the lighting, lighting modes section
- Developed?
Adjust the lighting around your flag, and change the lighting mode.
Click/tap here to expand/collapse the shine a light section
- Developed?
Shine a light on your flag with a searchlight.
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.
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.
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.
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.
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.
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.
Click/tap here to expand/collapse the homepage section
- Developed?
A flag homepage for the program.
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.
Click/tap here to expand/collapse the other items to throw section
- Developed?
More accessories for different items to throw at the flag.
Click/tap here to expand/collapse the flag Emoji mode section
- Developed?
Enable flag Emoji mode to show flag Emojis as waving flags.
Click/tap here to expand/collapse the flag Emoji import section
- Developed?
Import different flag Emoji styles, and wave them as flags.
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.
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.
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.
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
Click/tap here to expand/collapse the desktop application section
- Developed?
Develop desktop applications for this project. See below
Click/tap here to expand/collapse the web application section
- Developed?
Develop web applications for this project. See below
Click/tap here to expand/collapse the mobile application section
- Developed?
Develop mobile applications for this project. See below
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.
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.
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.
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:
- Monochrome (2 color) mode
- 4 bit (16 color) mode
- 5 bit (32 color) mode
- 6 bit (64 color) mode
- 7 bit (128 color) mode
- 8 bit (256 color) mode
- 12 bit (4096 color) mode
- 16 bit (65536 color) mode
- 24 bit (16777216 color) mode
- 32 bit (4294967296 color) mode
- 48 bit (281474976710656 color) mode
- 64 bit (9223372036854775807 color) mode
Click/tap here to expand/collapse the filters section
- Developed?
Choose between different filters to display your flag alongside.
- Confetti filter
- Other
Click/tap here to expand/collapse the slideshow mode section
- Developed?
Enter slideshow mode, and showcase a slideshow of flags, flag backgrounds, or both.
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.
Click/tap here to expand/collapse the multiple flag poles section
- Developed?
Add support for multiple flag poles at once.
Click/tap here to expand/collapse the flag pole size section
- Developed?
Change the size of the flag pole, both perimeter, width, and height
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.
Click/tap here to expand/collapse the flag pole material download section
- Developed?
Download the material file for the flag pole.
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
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)
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).
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:
- Scissors
- Knives
- Swords
- Fire arrows
- Flashlight
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)
Click/tap here to expand/collapse the transparency level section
- Developed?
Change the transparency/opacity of the flag, the flagpole, or both.
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.
Click/tap here to expand/collapse the Feedback section
Feedback for this project.
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)
End of feedback
Click/tap here to expand/collapse the Databases section
Custom databases that can be used within the Flag Simulator project.
Click/tap here to expand/collapse the Flags of the World (FOTW) database section
Repository listing:
End of database listing.
Click/tap here to expand/collapse the Variants section
See: Flag-Simulator_REPOLIST.urll
Click/tap here to expand/collapse the Web Applications section
Click/tap here to expand/collapse Desktop Web Applications section
Click/tap here to expand/collapse the Mobile Applications section
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.
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 |
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)
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.
Click/tap here to expand/collapse the Installation section
See: INSTALL.rst [OUTDATED, as of 2025, Wednesday, May 7th)
Click/tap here to expand/collapse the Credits section
See: CREDITS.wiki [OUTDATED, as of 2025, Wednesday, May 7th)
Click/tap here to expand/collapse the Authors section
See: AUTHORS.md [OUTDATED, as of 2025, Wednesday, May 7th)
Click/tap here to expand/collapse the Documentation section
Documentation is housed in a separate repository.
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
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
Click/tap here to expand/collapse this section
Common tags for this project.
| #flag | #flags | #flagwaver | #flag-simulator | #flag-simulator-project | #flag-simulator-development | #flag-simulator-docs | #flag-simulator-documentation | #seanpm2001-flag-simulator | #vexillology |
Click/tap here to expand/collapse this section
- File type:
Markdown document (*.md *.mkd *.mdown *.markdown) - File version:
6 (2025, Thursday, May 22nd at 05:33 pm PST) - Line count (including blank lines and compiler line):
01,787 - Word count:
11,098 - Character count (with spaces):
075,418 characters - Character count (without spaces)
064,827 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
Click/tap here to expand/collapse the file history section
Click/tap here to expand/collapse the file history section entry for version 1
Note: This is the first version.
Changes:
- Started the file
- Referenced the placeholder logo
- Added the title section
- Added the Features section
- Added the Flag physics section
- Added the Flag direction section
- Added the Wind direction section
- Added the Wind control section
- Added the Barometric pressure section
- Added the Different backgrounds section
- Added the Background videos section
- Added the Export section
- Added the Embed into a webpage section
- Added the Database of flags section
- Added the Upload custom flags section
- Added the Pennants section
- Added the Information on each flag section
- Added the FlagW file (waving flag data file) section
- Added the Flag burning section
- Added the Information on religious flags section
- Added the Flag tearing section
- Added the Half mast section
- Added the Raising/lowering section
- Added the Customizable flag poles section
- Added the Flag poles section
- Added the SVG, PNG, JPEG, GIF, TIFF, BMP, WEBP, NETP, ICO, GIF_C200, among other supported formats section
- Added the Various buttons section
- Added the Ability to send an army to take down the flag section
- Added the Offline functionality section
- Added the Rain and weather effects section
- Added the Play audio (national anthems, and anthem library) section
- Added the Simulate real weather (with weather services, and data files for weather events) section
- Added the Flag construction mode section
- Added the Flag folding section
- Added the Lighting, lighting modes section
- Added the Shine a light section
- Added the Flashlight (movable with cursor/finger) section
- Added the Customizable flashlight, different light colors, sizes, strengths of light section
- Added the Flag weaving section
- Added the Buy an actual flag (based on the one shown) section
- Added the VIAF flag section
- Added the Default flag section
- Added the Homepage section
- Added the Fire arrows section
- Added the Other items to throw section
- Added the Flag Emoji mode section
- Added the Flag Emoji import section
- Added the Flag search (search for a flag, Emojis also work as a search option) section
- Added the User interface skins section
- Added the Censorship modes for hate flags, Socialist/Communist flags, terrorist flags, etc section
- Added the Age rating section
- Added the Desktop application (with ports in Python, Java, C, and Rust) section
- Added the Web application (with ports in Ruby, JavaScript, PHP, and WebAssembly) section
- Added the Mobile application (with ports in Java, Kotlin, Swift, and C) section
- Added the Flag text and copy text from flag section
- Added the ASCII mode, with text color toggle section
- Added the Creating large flags (up to worlds largest) section
- Added the 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 section
- Added the Flag code dictionary section
- Added the Flag creator: Your own flag (built-in editor) add description, colors, shapes, graphics, text mode, description, and flag code section
- Added the 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 section
- Added the Filters section
- Added the Slideshow mode section
- Added the Customize the area around the flag pole section
- Added the Multiple flag poles section
- Added the Flag pole size section
- Added the Flag pole material (metal, wood, etc.) section
- Added the Flag pole material download section
- Added the Dimensional modes: 2D, 3D, 4D section
- Added the Scissors, knives, and swords section
- Added the Acid raid effect section
- Added the Fun facts about Vexillology in the UI section
- Added the Accessories menu and the ability to import new ones (built-in: scissors, knives, swords, fire arrows, flashlight) section
- Added the Accessory files: a specialized data file for the project section
- Added the Transparency level section
- Added the Flag stamps section
- Added the Feedback from 2025, April section
- Added the Databases section
- Added the Variants section
- Added the Web Applications section
- Added the Desktop Applications section
- Added the Mobile Applications section
- Added information on development targets
- Added the Concept 2025.04.23 section
- Added the File info section
- No other changes in version 1
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
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
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
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
Click/tap here to expand/collapse the file history section entry for version 6
Note: This is the sixth version, which fixes some typos..
Changes:
- Updated the File info section
- Updated the File History section
- Updated the Databases section
- No other changes in version 6
End of file history section.
You have reached the bottom of this page.
End of article.
