Skip to content

The definitive list of the best of (consumer facing) open source.

Made navigation bar dynamic

Lucas9ca18417d8bb
diff --git a/README.md b/README.md
index ac779e6..41bea95 100644
--- a/README.md
+++ b/README.md
@@ -19,6 +19,8 @@
##
<h4 align="center">
+ <b>[ Main / All ]</b>
+ <span> · </span>
<a href="https://github.com/mustbeperfect/definitive-opensource/blob/main/resources/readmes/windows.md">Windows</a>
<span> · </span>
<a href="https://github.com/mustbeperfect/definitive-opensource/blob/main/resources/readmes/macos.md">MacOS</a>
diff --git a/core/components/header.md b/core/components/header.md
index 06d5c93..9bd4358 100644
--- a/core/components/header.md
+++ b/core/components/header.md
@@ -7,15 +7,7 @@
##
-<h4 align="center">
- <a href="https://github.com/mustbeperfect/definitive-opensource/blob/main/resources/readmes/windows.md">Windows</a>
- <span> · </span>
- <a href="https://github.com/mustbeperfect/definitive-opensource/blob/main/resources/readmes/macos.md">MacOS</a>
- <span> · </span>
- <a href="https://github.com/mustbeperfect/definitive-opensource/blob/main/resources/readmes/linux.md">Linux</a>
- <span> · </span>
- <a href="https://github.com/mustbeperfect/definitive-opensource/blob/main/resources/readmes/selfhost.md">SelfHosted</a>
-</h4>
+<!-- NAVBAR -->
##
diff --git a/core/components/linuxheader.md b/core/components/linuxheader.md
deleted file mode 100644
index 8b63825..0000000
--- a/core/components/linuxheader.md
+++ /dev/null
@@ -1,3 +0,0 @@
-
-<h1 align="center">[ Linux ] </h1>
-<p align="center">Filtered for Linux and cross-platform apps</p>
diff --git a/core/components/macosheader.md b/core/components/macosheader.md
deleted file mode 100644
index 5279545..0000000
--- a/core/components/macosheader.md
+++ /dev/null
@@ -1,3 +0,0 @@
-
-<h1 align="center">[ MacOS ] </h1>
-<p align="center">Filtered for MacOS and cross-platform apps</p>
diff --git a/core/components/selfhostheader.md b/core/components/selfhostheader.md
deleted file mode 100644
index cc758ac..0000000
--- a/core/components/selfhostheader.md
+++ /dev/null
@@ -1,3 +0,0 @@
-
-<h1 align="center">[ SelfHosted ] </h1>
-<p align="center">Filtered for selfhosted apps</p>
diff --git a/core/components/windowsheader.md b/core/components/windowsheader.md
deleted file mode 100644
index 1f9e93a..0000000
--- a/core/components/windowsheader.md
+++ /dev/null
@@ -1,3 +0,0 @@
-
-<h1 align="center">[ Windows ] </h1>
-<p align="center">Filtered for Windows and cross-platform apps</p>
diff --git a/core/source/generation/header_generator.py b/core/source/generation/header_generator.py
new file mode 100644
index 0000000..22697ec
--- /dev/null
+++ b/core/source/generation/header_generator.py
@@ -0,0 +1,145 @@
+import json
+from pathlib import Path
+import re
+import sys
+
+CORE_DIR = Path(__file__).resolve().parents[2]
+if str(CORE_DIR) not in sys.path:
+ sys.path.insert(0, str(CORE_DIR))
+
+from source.generation.contents_generator import app_matches_platform # noqa: E402
+from source.utils.path_utils import COMPONENTS_DIR, DYNAMIC_DATA_DIR # noqa: E402
+
+PLATFORM_HEADERS = {
+ "all": {
+ "title": "definitive-opensource",
+ "description": "The definitive list of the best of everything open source",
+ },
+ "windows": {
+ "title": "Windows",
+ "description": "Filtered for Windows and cross-platform apps",
+ },
+ "macos": {
+ "title": "MacOS",
+ "description": "Filtered for MacOS and cross-platform apps",
+ },
+ "linux": {
+ "title": "Linux",
+ "description": "Filtered for Linux and cross-platform apps",
+ },
+ "selfhost": {
+ "title": "SelfHosted",
+ "description": "Filtered for selfhosted apps",
+ },
+}
+
+NAV_ITEMS = [
+ {
+ "id": "all",
+ "name": "Main / All",
+ "url": "https://github.com/mustbeperfect/definitive-opensource/blob/main/README.md",
+ },
+ {
+ "id": "windows",
+ "name": "Windows",
+ "url": "https://github.com/mustbeperfect/definitive-opensource/blob/main/resources/readmes/windows.md",
+ },
+ {
+ "id": "macos",
+ "name": "MacOS",
+ "url": "https://github.com/mustbeperfect/definitive-opensource/blob/main/resources/readmes/macos.md",
+ },
+ {
+ "id": "linux",
+ "name": "Linux",
+ "url": "https://github.com/mustbeperfect/definitive-opensource/blob/main/resources/readmes/linux.md",
+ },
+ {
+ "id": "selfhost",
+ "name": "SelfHosted",
+ "url": "https://github.com/mustbeperfect/definitive-opensource/blob/main/resources/readmes/selfhost.md",
+ },
+]
+
+
+def normalize_platform(platform: str) -> str:
+ p = platform.lower()
+ if p in ("main", "readme"):
+ return "all"
+ if p == "selfhosted":
+ return "selfhost"
+ return p
+
+
+def generate_top_header(platform: str = "all") -> str:
+ norm_platform = normalize_platform(platform)
+ with open(
+ DYNAMIC_DATA_DIR / "applications_generated.json", "r", encoding="utf-8"
+ ) as f:
+ data = json.load(f)
+
+ applications = data.get("applications", [])
+ if norm_platform == "all":
+ project_count = len(applications)
+ else:
+ project_count = len(
+ [app for app in applications if app_matches_platform(app, norm_platform)]
+ )
+
+ info = PLATFORM_HEADERS.get(
+ norm_platform,
+ {
+ "title": platform.capitalize(),
+ "description": f"Filtered for {platform} apps",
+ },
+ )
+
+ header_content = f"""
+<table align="center">
+ <tr>
+ <td>🌍 v0.8.5-beta</td>
+ </tr>
+</table>
+
+<h1 align="center">[ {info['title']} ] </h1>
+<p align="center">{info['description']}</p>
+
+<p align="center"><code>Status: Active</code> - <code>Projects: {project_count}</code></p>
+"""
+ return header_content
+
+
+def generate_navbar(platform: str = "all") -> str:
+ norm_platform = normalize_platform(platform)
+ items_html = []
+ for item in NAV_ITEMS:
+ if item["id"] == norm_platform:
+ items_html.append(f"<b>[ {item['name']} ]</b>")
+ else:
+ items_html.append(f'<a href="{item["url"]}">{item["name"]}</a>')
+
+ joined = "\n <span> · </span>\n ".join(items_html)
+ return f"""<h4 align="center">
+ {joined}
+</h4>"""
+
+
+def generate_header(platform: str = "all") -> str:
+ top_header = generate_top_header(platform)
+ navbar = generate_navbar(platform)
+
+ with open(COMPONENTS_DIR / "header.md", "r", encoding="utf-8") as f:
+ header_template = f.read()
+
+ if "<!-- NAVBAR -->" in header_template:
+ body = header_template.replace("<!-- NAVBAR -->", navbar)
+ else:
+ body = re.sub(
+ r'<h4 align="center">[\s\S]*?</h4>', navbar, header_template
+ )
+
+ return f"\n{top_header.strip()}\n\n{body.strip()}\n"
+
+
+if __name__ == "__main__":
+ print(generate_header("all"))
diff --git a/core/source/generation/mainheader_generator.py b/core/source/generation/mainheader_generator.py
index 17b22bc..2d2506c 100644
--- a/core/source/generation/mainheader_generator.py
+++ b/core/source/generation/mainheader_generator.py
@@ -1,4 +1,3 @@
-import json
from pathlib import Path
import sys
@@ -6,33 +5,24 @@ CORE_DIR = Path(__file__).resolve().parents[2]
if str(CORE_DIR) not in sys.path:
sys.path.insert(0, str(CORE_DIR))
-from source.utils.path_utils import DYNAMIC_DATA_DIR # noqa: E402
+from source.generation.header_generator import ( # noqa: E402
+ generate_header,
+ generate_navbar,
+ generate_top_header,
+)
+__all__ = [
+ "generate_header",
+ "generate_navbar",
+ "generate_top_header",
+ "generate_mainheader",
+]
-# Generates mainheader with dynamic project count
-def generate_mainheader():
- with open(
- DYNAMIC_DATA_DIR / "applications_generated.json", "r", encoding="utf-8"
- ) as f:
- data = json.load(f)
- project_count = len(data.get("applications", []))
-
- header_content = f"""
-<table align="center">
- <tr>
- <td>🌍 v0.8.5-beta</td>
- </tr>
-</table>
-
-<h1 align="center">[ definitive-opensource ] </h1>
-<p align="center">The definitive list of the best of everything open source</p>
-
-<p align="center"><code>Status: Active</code> - <code>Projects: {project_count}</code></p>
-"""
-
- return header_content
+def generate_mainheader(platform="all"):
+ """Backward-compatible wrapper for generating top header or full header."""
+ return generate_top_header(platform)
if __name__ == "__main__":
- generate_mainheader()
+ print(generate_mainheader())
diff --git a/core/source/generation/readme_generator.py b/core/source/generation/readme_generator.py
index f87e7d7..4df5227 100644
--- a/core/source/generation/readme_generator.py
+++ b/core/source/generation/readme_generator.py
@@ -7,7 +7,7 @@ if str(CORE_DIR) not in sys.path:
from source.generation.archive_generator import generate_archive_section # noqa: E402
from source.generation.contents_generator import generate_contents # noqa: E402
-from source.generation.mainheader_generator import generate_mainheader # noqa: E402
+from source.generation.header_generator import generate_header # noqa: E402
from source.generation.tableofcontents_generator import ( # noqa: E402
generate_table_of_contents,
)
@@ -15,26 +15,12 @@ from source.utils.path_utils import COMPONENTS_DIR, READMES_DIR, REPO_ROOT # no
platforms = ["all", "windows", "macos", "linux", "selfhost"]
-# Platforms mapped to corresponding header files
-header_files = {
- "all": COMPONENTS_DIR / "header.md",
- "windows": COMPONENTS_DIR / "windowsheader.md",
- "macos": COMPONENTS_DIR / "macosheader.md",
- "linux": COMPONENTS_DIR / "linuxheader.md",
- "selfhost": COMPONENTS_DIR / "selfhostheader.md",
-}
-
def generate_readme_for_platform(platform):
content = ""
- header_file = header_files.get(platform, COMPONENTS_DIR / "header.md")
# Inject every component of the list from top to bottom
- if platform == "all":
- content += generate_mainheader()
-
- with open(header_file, "r", encoding="utf-8") as f:
- content += f.read() + "\n"
+ content += generate_header(platform) + "\n"
with open(COMPONENTS_DIR / "tags.md", "r", encoding="utf-8") as f:
content += f.read() + "\n"
diff --git a/core/tests/test_generation.py b/core/tests/test_generation.py
index e50f90a..dde960d 100644
--- a/core/tests/test_generation.py
+++ b/core/tests/test_generation.py
@@ -14,6 +14,11 @@ from source.generation.contents_generator import ( # noqa: E402
app_matches_platform,
generate_contents,
)
+from source.generation.header_generator import ( # noqa: E402
+ generate_header,
+ generate_navbar,
+ generate_top_header,
+)
from source.generation.tableofcontents_generator import ( # noqa: E402
generate_table_of_contents,
)
@@ -108,6 +113,52 @@ class TestGeneration(unittest.TestCase):
self.assertNotIn("EMACS Packages", all_toc)
self.assertNotIn("### EMACS Packages", all_contents)
+ def test_navbar_highlighting(self):
+ platforms = {
+ "all": "Main / All",
+ "windows": "Windows",
+ "macos": "MacOS",
+ "linux": "Linux",
+ "selfhost": "SelfHosted",
+ }
+ for current_platform, current_name in platforms.items():
+ navbar = generate_navbar(current_platform)
+ # The current platform must be bold and bracketed, NOT a link
+ self.assertIn(f"<b>[ {current_name} ]</b>", navbar)
+ self.assertNotIn(f'>{current_name}</a>', navbar)
+
+ # All other platforms must be links
+ for other_platform, other_name in platforms.items():
+ if other_platform == current_platform:
+ continue
+ self.assertIn(f">{other_name}</a>", navbar)
+ self.assertNotIn(f"<b>[ {other_name} ]</b>", navbar)
+
+ def test_unified_header_contains_all_components(self):
+ platforms = ["all", "windows", "macos", "linux", "selfhost"]
+ for platform in platforms:
+ top_header = generate_top_header(platform)
+ self.assertIn("🌍 v0.8.5-beta", top_header)
+ self.assertIn("Status: Active", top_header)
+
+ header = generate_header(platform)
+ # Version badge
+ self.assertIn("🌍 v0.8.5-beta", header)
+ # Status
+ self.assertIn("Status: Active", header)
+ self.assertIn("Projects:", header)
+ # Tips & Web client link
+ self.assertIn("[!TIP]", header)
+ self.assertIn("[!NOTE]", header)
+ self.assertIn("https://dos.mustbeperfect.com", header)
+ # Navigation bar
+ self.assertIn('<h4 align="center">', header)
+ # Explanation sections
+ self.assertIn("**Our Goal -**", header)
+ self.assertIn("More Information", header)
+ self.assertIn("How The List Works", header)
+ self.assertIn("Project Status", header)
+
if __name__ == "__main__":
unittest.main()
diff --git a/resources/dev/ARCHITECTURE.md b/resources/dev/ARCHITECTURE.md
index ff65bd1..ef9f8ed 100644
--- a/resources/dev/ARCHITECTURE.md
+++ b/resources/dev/ARCHITECTURE.md
@@ -9,7 +9,7 @@ The core of this list is powered by Python using UV and Ruff for linting and for
All applications are stored inside [`applications.json`](core/data/dynamic/applications.json). Categories are declared inside [`categories.json`](core/data/static/categories.json). Instead of a nested format with subcategories as on object of it's parent, we've given subcategories a `parent` attribute. There's also a [`tags.json`](core/data/static/tags.json). Instead of putting the emoji inside of the ```tags``` attribute in `applications.json`, the id is used, for example, `commercial` or `disruptive`.. These id's are mapped to their corresponding emoji for when the READMEs are generated and makes``applications.json``` more readable.
-The generation scripts are inside of the [`core/source/generation`](core/source/generation) directory. [`mainheader_generator.py`](core/source/generation/mainheader_generator.py) generates the very top header with the dynamic project count. Then, depending on the platform being generating, it inserts [`header.md`](core/components/header.md), [`macosheader.md`](core/components/macosheader.md), etc.
+The generation scripts are inside of the [`core/source/generation`](core/source/generation) directory. [`header_generator.py`](core/source/generation/header_generator.py) generates the unified header for each platform with dynamic project counts and a navigation bar highlighting the active platform, injecting [`header.md`](core/components/header.md).
[`tableofcontents_generator.py`](core/source/generation/tableofcontents_generator.py) generates the table of contents. It creates one, expandable but hidden by default, with all subsections listed alphabetically. The default TOC shows parent categories alphabetically with subcategories underneath, also alphabetically.
diff --git a/resources/readmes/linux.md b/resources/readmes/linux.md
index 02ada6a..18808b5 100644
--- a/resources/readmes/linux.md
+++ b/resources/readmes/linux.md
@@ -1,7 +1,80 @@
+<table align="center">
+ <tr>
+ <td>🌍 v0.8.5-beta</td>
+ </tr>
+</table>
+
<h1 align="center">[ Linux ] </h1>
<p align="center">Filtered for Linux and cross-platform apps</p>
+<p align="center"><code>Status: Active</code> - <code>Projects: 457</code></p>
+
+> [!TIP]
+> This list is EXCLUSIVELY for apps that you use directly such as desktop apps, selfhosted apps, and command line utilities. Developer facing tools like languages, frameworks, and libraries are excluded.
+
+> [!NOTE]
+> Due to the increasing size of this list, the README has become rather difficult to navigate. Our [web client](https://dos.mustbeperfect.com) is recommended for a better user experience.
+
+##
+
+<h4 align="center">
+ <a href="https://github.com/mustbeperfect/definitive-opensource/blob/main/README.md">Main / All</a>
+ <span> · </span>
+ <a href="https://github.com/mustbeperfect/definitive-opensource/blob/main/resources/readmes/windows.md">Windows</a>
+ <span> · </span>
+ <a href="https://github.com/mustbeperfect/definitive-opensource/blob/main/resources/readmes/macos.md">MacOS</a>
+ <span> · </span>
+ <b>[ Linux ]</b>
+ <span> · </span>
+ <a href="https://github.com/mustbeperfect/definitive-opensource/blob/main/resources/readmes/selfhost.md">SelfHosted</a>
+</h4>
+
+##
+
+**Our Goal -** There's plenty of awesome lists on GitHub, many focusing on open source specifically. However I've found them including many long-deprecated apps, cluttered with smaller projects on the verge of extinction, or missing a lot of modern open source projects.
+
+This list aims to serve as a single centralized location for the best of open source, characterized by a solid user base, solid set of contributors, visible long term growth, and overall product quality.
+
+<details>
+ <summary><b>More Information</b></summary><br />
+ Definitive-opensource aims to consolidate only the best open source projects. Our guidelines include strict minimum requirements and additional research for vetting. For a project to pass it's likely popular enough to survive far into the future, however we continously monitor projects on the list and remove anything that no longer fits the criteria.
+ <p>&nbsp;</p>
+ It is a fundamental goal for this list to be as neutral as possible and simply present options, not persuade or redact, regardless of the maintainer's opinion. Projects that fit the criteria, which by passing will inherently be used by thousands to millions, are put on the list. This list is "curated" - not relative to opinion but statistics and facts.
+ <p>&nbsp;</p>
+ Although the list is called definitive, in this context it doesn't quite mean the implied dictionary definition of finality. This project can only survive and thrive through continuous contributions by the community, as this list is, in itself, open source.
+</details>
+
+<details>
+ <summary><b>How The List Works</b></summary><br />
+
+ Definitive-opensource was initially a single markdown file that was edited directly. However, as the list scaled, this manual approach proved cumbersome and limited. Additionally, as popularity increased, we recieved many requests for README's of individual platforms - something that would be not be realistic to do manually.
+ <p>&nbsp;</p>
+ As of v0.6.2-beta, the project was fundamentally re-made. Categories and applications were put in categories.json and applications.json, respectively. Python scripts were made to generate one main list and more platform-specific lists. This was paired with GitHub actions to run the scripts when any changes were made. This opened up a world of possibilies, making refactoring the list format far easier whilst eliminating typos.
+ <p>&nbsp;</p>
+ This list aims to stand in the middle ground between human input and automation. Mostly automated websites exist for finding open source projects, but statistics alone fails to encompass the complete picture. This list has scripts to automate markdown formatting, updating stats, and finding potentially abandoned projects. However, the actual processes of choosing which projects make it onto the list, which ones should be removed, and what tags to assign are controlled entirely by humans.
+</details>
+
+<details>
+ <summary><b>Project Status</b></summary><br />
+
+```css
+Active - Active Development
+```
+```
+Incremental - Minor Updates
+```
+```
+Maintenance - Critical Fixes
+```
+```
+Idle - Temporarily Paused
+```
+```
+Abandoned - Development Halted
+```
+</details>
+
## Tags
### Alerts
diff --git a/resources/readmes/macos.md b/resources/readmes/macos.md
index efc87e1..ed3cebb 100644
--- a/resources/readmes/macos.md
+++ b/resources/readmes/macos.md
@@ -1,7 +1,80 @@
+<table align="center">
+ <tr>
+ <td>🌍 v0.8.5-beta</td>
+ </tr>
+</table>
+
<h1 align="center">[ MacOS ] </h1>
<p align="center">Filtered for MacOS and cross-platform apps</p>
+<p align="center"><code>Status: Active</code> - <code>Projects: 515</code></p>
+
+> [!TIP]
+> This list is EXCLUSIVELY for apps that you use directly such as desktop apps, selfhosted apps, and command line utilities. Developer facing tools like languages, frameworks, and libraries are excluded.
+
+> [!NOTE]
+> Due to the increasing size of this list, the README has become rather difficult to navigate. Our [web client](https://dos.mustbeperfect.com) is recommended for a better user experience.
+
+##
+
+<h4 align="center">
+ <a href="https://github.com/mustbeperfect/definitive-opensource/blob/main/README.md">Main / All</a>
+ <span> · </span>
+ <a href="https://github.com/mustbeperfect/definitive-opensource/blob/main/resources/readmes/windows.md">Windows</a>
+ <span> · </span>
+ <b>[ MacOS ]</b>
+ <span> · </span>
+ <a href="https://github.com/mustbeperfect/definitive-opensource/blob/main/resources/readmes/linux.md">Linux</a>
+ <span> · </span>
+ <a href="https://github.com/mustbeperfect/definitive-opensource/blob/main/resources/readmes/selfhost.md">SelfHosted</a>
+</h4>
+
+##
+
+**Our Goal -** There's plenty of awesome lists on GitHub, many focusing on open source specifically. However I've found them including many long-deprecated apps, cluttered with smaller projects on the verge of extinction, or missing a lot of modern open source projects.
+
+This list aims to serve as a single centralized location for the best of open source, characterized by a solid user base, solid set of contributors, visible long term growth, and overall product quality.
+
+<details>
+ <summary><b>More Information</b></summary><br />
+ Definitive-opensource aims to consolidate only the best open source projects. Our guidelines include strict minimum requirements and additional research for vetting. For a project to pass it's likely popular enough to survive far into the future, however we continously monitor projects on the list and remove anything that no longer fits the criteria.
+ <p>&nbsp;</p>
+ It is a fundamental goal for this list to be as neutral as possible and simply present options, not persuade or redact, regardless of the maintainer's opinion. Projects that fit the criteria, which by passing will inherently be used by thousands to millions, are put on the list. This list is "curated" - not relative to opinion but statistics and facts.
+ <p>&nbsp;</p>
+ Although the list is called definitive, in this context it doesn't quite mean the implied dictionary definition of finality. This project can only survive and thrive through continuous contributions by the community, as this list is, in itself, open source.
+</details>
+
+<details>
+ <summary><b>How The List Works</b></summary><br />
+
+ Definitive-opensource was initially a single markdown file that was edited directly. However, as the list scaled, this manual approach proved cumbersome and limited. Additionally, as popularity increased, we recieved many requests for README's of individual platforms - something that would be not be realistic to do manually.
+ <p>&nbsp;</p>
+ As of v0.6.2-beta, the project was fundamentally re-made. Categories and applications were put in categories.json and applications.json, respectively. Python scripts were made to generate one main list and more platform-specific lists. This was paired with GitHub actions to run the scripts when any changes were made. This opened up a world of possibilies, making refactoring the list format far easier whilst eliminating typos.
+ <p>&nbsp;</p>
+ This list aims to stand in the middle ground between human input and automation. Mostly automated websites exist for finding open source projects, but statistics alone fails to encompass the complete picture. This list has scripts to automate markdown formatting, updating stats, and finding potentially abandoned projects. However, the actual processes of choosing which projects make it onto the list, which ones should be removed, and what tags to assign are controlled entirely by humans.
+</details>
+
+<details>
+ <summary><b>Project Status</b></summary><br />
+
+```css
+Active - Active Development
+```
+```
+Incremental - Minor Updates
+```
+```
+Maintenance - Critical Fixes
+```
+```
+Idle - Temporarily Paused
+```
+```
+Abandoned - Development Halted
+```
+</details>
+
## Tags
### Alerts
diff --git a/resources/readmes/selfhost.md b/resources/readmes/selfhost.md
index 79e4df9..c555b07 100644
--- a/resources/readmes/selfhost.md
+++ b/resources/readmes/selfhost.md
@@ -1,7 +1,80 @@
+<table align="center">
+ <tr>
+ <td>🌍 v0.8.5-beta</td>
+ </tr>
+</table>
+
<h1 align="center">[ SelfHosted ] </h1>
<p align="center">Filtered for selfhosted apps</p>
+<p align="center"><code>Status: Active</code> - <code>Projects: 224</code></p>
+
+> [!TIP]
+> This list is EXCLUSIVELY for apps that you use directly such as desktop apps, selfhosted apps, and command line utilities. Developer facing tools like languages, frameworks, and libraries are excluded.
+
+> [!NOTE]
+> Due to the increasing size of this list, the README has become rather difficult to navigate. Our [web client](https://dos.mustbeperfect.com) is recommended for a better user experience.
+
+##
+
+<h4 align="center">
+ <a href="https://github.com/mustbeperfect/definitive-opensource/blob/main/README.md">Main / All</a>
+ <span> · </span>
+ <a href="https://github.com/mustbeperfect/definitive-opensource/blob/main/resources/readmes/windows.md">Windows</a>
+ <span> · </span>
+ <a href="https://github.com/mustbeperfect/definitive-opensource/blob/main/resources/readmes/macos.md">MacOS</a>
+ <span> · </span>
+ <a href="https://github.com/mustbeperfect/definitive-opensource/blob/main/resources/readmes/linux.md">Linux</a>
+ <span> · </span>
+ <b>[ SelfHosted ]</b>
+</h4>
+
+##
+
+**Our Goal -** There's plenty of awesome lists on GitHub, many focusing on open source specifically. However I've found them including many long-deprecated apps, cluttered with smaller projects on the verge of extinction, or missing a lot of modern open source projects.
+
+This list aims to serve as a single centralized location for the best of open source, characterized by a solid user base, solid set of contributors, visible long term growth, and overall product quality.
+
+<details>
+ <summary><b>More Information</b></summary><br />
+ Definitive-opensource aims to consolidate only the best open source projects. Our guidelines include strict minimum requirements and additional research for vetting. For a project to pass it's likely popular enough to survive far into the future, however we continously monitor projects on the list and remove anything that no longer fits the criteria.
+ <p>&nbsp;</p>
+ It is a fundamental goal for this list to be as neutral as possible and simply present options, not persuade or redact, regardless of the maintainer's opinion. Projects that fit the criteria, which by passing will inherently be used by thousands to millions, are put on the list. This list is "curated" - not relative to opinion but statistics and facts.
+ <p>&nbsp;</p>
+ Although the list is called definitive, in this context it doesn't quite mean the implied dictionary definition of finality. This project can only survive and thrive through continuous contributions by the community, as this list is, in itself, open source.
+</details>
+
+<details>
+ <summary><b>How The List Works</b></summary><br />
+
+ Definitive-opensource was initially a single markdown file that was edited directly. However, as the list scaled, this manual approach proved cumbersome and limited. Additionally, as popularity increased, we recieved many requests for README's of individual platforms - something that would be not be realistic to do manually.
+ <p>&nbsp;</p>
+ As of v0.6.2-beta, the project was fundamentally re-made. Categories and applications were put in categories.json and applications.json, respectively. Python scripts were made to generate one main list and more platform-specific lists. This was paired with GitHub actions to run the scripts when any changes were made. This opened up a world of possibilies, making refactoring the list format far easier whilst eliminating typos.
+ <p>&nbsp;</p>
+ This list aims to stand in the middle ground between human input and automation. Mostly automated websites exist for finding open source projects, but statistics alone fails to encompass the complete picture. This list has scripts to automate markdown formatting, updating stats, and finding potentially abandoned projects. However, the actual processes of choosing which projects make it onto the list, which ones should be removed, and what tags to assign are controlled entirely by humans.
+</details>
+
+<details>
+ <summary><b>Project Status</b></summary><br />
+
+```css
+Active - Active Development
+```
+```
+Incremental - Minor Updates
+```
+```
+Maintenance - Critical Fixes
+```
+```
+Idle - Temporarily Paused
+```
+```
+Abandoned - Development Halted
+```
+</details>
+
## Tags
### Alerts
diff --git a/resources/readmes/windows.md b/resources/readmes/windows.md
index d142518..56c6ae4 100644
--- a/resources/readmes/windows.md
+++ b/resources/readmes/windows.md
@@ -1,7 +1,80 @@
+<table align="center">
+ <tr>
+ <td>🌍 v0.8.5-beta</td>
+ </tr>
+</table>
+
<h1 align="center">[ Windows ] </h1>
<p align="center">Filtered for Windows and cross-platform apps</p>
+<p align="center"><code>Status: Active</code> - <code>Projects: 461</code></p>
+
+> [!TIP]
+> This list is EXCLUSIVELY for apps that you use directly such as desktop apps, selfhosted apps, and command line utilities. Developer facing tools like languages, frameworks, and libraries are excluded.
+
+> [!NOTE]
+> Due to the increasing size of this list, the README has become rather difficult to navigate. Our [web client](https://dos.mustbeperfect.com) is recommended for a better user experience.
+
+##
+
+<h4 align="center">
+ <a href="https://github.com/mustbeperfect/definitive-opensource/blob/main/README.md">Main / All</a>
+ <span> · </span>
+ <b>[ Windows ]</b>
+ <span> · </span>
+ <a href="https://github.com/mustbeperfect/definitive-opensource/blob/main/resources/readmes/macos.md">MacOS</a>
+ <span> · </span>
+ <a href="https://github.com/mustbeperfect/definitive-opensource/blob/main/resources/readmes/linux.md">Linux</a>
+ <span> · </span>
+ <a href="https://github.com/mustbeperfect/definitive-opensource/blob/main/resources/readmes/selfhost.md">SelfHosted</a>
+</h4>
+
+##
+
+**Our Goal -** There's plenty of awesome lists on GitHub, many focusing on open source specifically. However I've found them including many long-deprecated apps, cluttered with smaller projects on the verge of extinction, or missing a lot of modern open source projects.
+
+This list aims to serve as a single centralized location for the best of open source, characterized by a solid user base, solid set of contributors, visible long term growth, and overall product quality.
+
+<details>
+ <summary><b>More Information</b></summary><br />
+ Definitive-opensource aims to consolidate only the best open source projects. Our guidelines include strict minimum requirements and additional research for vetting. For a project to pass it's likely popular enough to survive far into the future, however we continously monitor projects on the list and remove anything that no longer fits the criteria.
+ <p>&nbsp;</p>
+ It is a fundamental goal for this list to be as neutral as possible and simply present options, not persuade or redact, regardless of the maintainer's opinion. Projects that fit the criteria, which by passing will inherently be used by thousands to millions, are put on the list. This list is "curated" - not relative to opinion but statistics and facts.
+ <p>&nbsp;</p>
+ Although the list is called definitive, in this context it doesn't quite mean the implied dictionary definition of finality. This project can only survive and thrive through continuous contributions by the community, as this list is, in itself, open source.
+</details>
+
+<details>
+ <summary><b>How The List Works</b></summary><br />
+
+ Definitive-opensource was initially a single markdown file that was edited directly. However, as the list scaled, this manual approach proved cumbersome and limited. Additionally, as popularity increased, we recieved many requests for README's of individual platforms - something that would be not be realistic to do manually.
+ <p>&nbsp;</p>
+ As of v0.6.2-beta, the project was fundamentally re-made. Categories and applications were put in categories.json and applications.json, respectively. Python scripts were made to generate one main list and more platform-specific lists. This was paired with GitHub actions to run the scripts when any changes were made. This opened up a world of possibilies, making refactoring the list format far easier whilst eliminating typos.
+ <p>&nbsp;</p>
+ This list aims to stand in the middle ground between human input and automation. Mostly automated websites exist for finding open source projects, but statistics alone fails to encompass the complete picture. This list has scripts to automate markdown formatting, updating stats, and finding potentially abandoned projects. However, the actual processes of choosing which projects make it onto the list, which ones should be removed, and what tags to assign are controlled entirely by humans.
+</details>
+
+<details>
+ <summary><b>Project Status</b></summary><br />
+
+```css
+Active - Active Development
+```
+```
+Incremental - Minor Updates
+```
+```
+Maintenance - Critical Fixes
+```
+```
+Idle - Temporarily Paused
+```
+```
+Abandoned - Development Halted
+```
+</details>
+
## Tags
### Alerts