starred/definitive-opensource
1
0
Fork 0
mirror of https://github.com/mustbeperfect/definitive-opensource.git synced 2026-04-17 21:54:05 +02:00
Code Issues Packages Projects Releases Wiki Activity

Added dynamic project count and minor fixes

Browse Source
This commit is contained in:
Lucas
2025-03-22 14:54:59 -07:00
parent 5a52274210
commit 652627bd79
16 changed files with 134 additions and 19 deletions
Download Patch File Download Diff File Expand all files Collapse all files

BIN
assets/osi_symbol.webp Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 15 KiB

1
assets/readme.md
View File

@@ -1 +0,0 @@

7
readmes/linux.md
View File

@@ -1,4 +1,7 @@
<h1 align="center">[ Linux ] </h1>
<p align="center">Filtered for Linux and cross-platform apps</p>
## Tags
### Alerts
@@ -12,6 +15,8 @@
`🟥` - Corporate influence
`🔺` - Commercial
`🧪` - Experimental (Pre-Alpha)
`🚧` - Critically unstable/buggy
@@ -42,6 +47,7 @@
`CLI+` - CLI in addition to GUI
`Windows`, `MacOS`, `Linux`, `Android`, `IOS`, `CLI`, `SelfHost`, `Web`, `VSCode`, `JetBrains`, `Chromium`, `Firefox`, `Plugin`, `Extension`, `N/A`
## Table of Contents
<details>
@@ -1036,6 +1042,7 @@
| [XPipe](https://github.com/xpipe-io/xpipe) | Your entire server infrastructure at your fingertips | `Cross` | ![GitHub Repo stars](https://img.shields.io/github/stars/xpipe-io/xpipe?style=for-the-badge&label=%20&color=white) |
## Honorable Mentions of Closed-Source Software
Some proprietary software just deserve recognition.
- [Davinci Resolve](https://www.blackmagicdesign.com/products/davinciresolve) - Professional Editing, Color, Effects and Audio Post!

7
readmes/macos.md
View File

@@ -1,4 +1,7 @@
<h1 align="center">[ MacOS ] </h1>
<p align="center">Filtered for MacOS and cross-platform apps</p>
## Tags
### Alerts
@@ -12,6 +15,8 @@
`🟥` - Corporate influence
`🔺` - Commercial
`🧪` - Experimental (Pre-Alpha)
`🚧` - Critically unstable/buggy
@@ -42,6 +47,7 @@
`CLI+` - CLI in addition to GUI
`Windows`, `MacOS`, `Linux`, `Android`, `IOS`, `CLI`, `SelfHost`, `Web`, `VSCode`, `JetBrains`, `Chromium`, `Firefox`, `Plugin`, `Extension`, `N/A`
## Table of Contents
<details>
@@ -1058,6 +1064,7 @@
| [XPipe](https://github.com/xpipe-io/xpipe) | Your entire server infrastructure at your fingertips | `Cross` | ![GitHub Repo stars](https://img.shields.io/github/stars/xpipe-io/xpipe?style=for-the-badge&label=%20&color=white) |
## Honorable Mentions of Closed-Source Software
Some proprietary software just deserve recognition.
- [Davinci Resolve](https://www.blackmagicdesign.com/products/davinciresolve) - Professional Editing, Color, Effects and Audio Post!

7
readmes/selfhost.md
View File

@@ -1,4 +1,7 @@
<h1 align="center">[ SelfHosted ] </h1>
<p align="center">Filtered for selfhosted apps</p>
## Tags
### Alerts
@@ -12,6 +15,8 @@
`🟥` - Corporate influence
`🔺` - Commercial
`🧪` - Experimental (Pre-Alpha)
`🚧` - Critically unstable/buggy
@@ -42,6 +47,7 @@
`CLI+` - CLI in addition to GUI
`Windows`, `MacOS`, `Linux`, `Android`, `IOS`, `CLI`, `SelfHost`, `Web`, `VSCode`, `JetBrains`, `Chromium`, `Firefox`, `Plugin`, `Extension`, `N/A`
## Table of Contents
<details>
@@ -930,6 +936,7 @@
| --- | --- | --- | --- |
## Honorable Mentions of Closed-Source Software
Some proprietary software just deserve recognition.
- [Davinci Resolve](https://www.blackmagicdesign.com/products/davinciresolve) - Professional Editing, Color, Effects and Audio Post!

7
readmes/windows.md
View File

@@ -1,4 +1,7 @@
<h1 align="center">[ Windows ] </h1>
<p align="center">Filtered for Windows and cross-platform apps</p>
## Tags
### Alerts
@@ -12,6 +15,8 @@
`🟥` - Corporate influence
`🔺` - Commercial
`🧪` - Experimental (Pre-Alpha)
`🚧` - Critically unstable/buggy
@@ -42,6 +47,7 @@
`CLI+` - CLI in addition to GUI
`Windows`, `MacOS`, `Linux`, `Android`, `IOS`, `CLI`, `SelfHost`, `Web`, `VSCode`, `JetBrains`, `Chromium`, `Firefox`, `Plugin`, `Extension`, `N/A`
## Table of Contents
<details>
@@ -1031,6 +1037,7 @@
| [XPipe](https://github.com/xpipe-io/xpipe) | Your entire server infrastructure at your fingertips | `Cross` | ![GitHub Repo stars](https://img.shields.io/github/stars/xpipe-io/xpipe?style=for-the-badge&label=%20&color=white) |
## Honorable Mentions of Closed-Source Software
Some proprietary software just deserve recognition.
- [Davinci Resolve](https://www.blackmagicdesign.com/products/davinciresolve) - Professional Editing, Color, Effects and Audio Post!

1
source/components/footer.md
View File

@@ -1,3 +1,4 @@
## Honorable Mentions of Closed-Source Software
Some proprietary software just deserve recognition.
- [Davinci Resolve](https://www.blackmagicdesign.com/products/davinciresolve) - Professional Editing, Color, Effects and Audio Post!

36
source/components/header.md
View File

@@ -1,15 +1,4 @@
<table align="center">
<tr>
<td>🇺🇦 v0.5.2-beta</td>
</tr>
</table>
<h1 align="center">[ definitive-opensource ] </h1>
<p align="center"> A definitive list of the best of everything open source</p>
<p align="center"><code>Status: Active</code> - <code>Projects: 422</code></p>
> [!TIP]
> Discussions and contributions are welcome! This project is in it's early stages and a lot hasn't been ironed out yet. For more information on [contributing](.github/CONTRIBUTING.md) and [guidelines](resources/dev/GUIDELINES.md) for open-source software submissions, consult their respective pages.
@@ -44,6 +33,31 @@ This list aims to serve as a single centralized location for the best of open so
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 makes refactoring the list format far easier and eliminates typos. This new system also opens the door to
<p>&nbsp;</p>
The project architecture is as follows:
```text
definitive-opensource/
├── assets/
├── readmes/
├── resources/
│ ├── backup/
│ └── dev/
├── source/
│ ├── components/
│ ├── data/
│ ├── scripts/
| └── utils/
│ └── testing/
└── README.md
```
</details>
## Project Status
```css
Active - Active Development

3
source/components/linuxheader.md
View File

@@ -0,0 +1,3 @@
<h1 align="center">[ Linux ] </h1>
<p align="center">Filtered for Linux and cross-platform apps</p>

3
source/components/macosheader.md
View File

@@ -0,0 +1,3 @@
<h1 align="center">[ MacOS ] </h1>
<p align="center">Filtered for MacOS and cross-platform apps</p>

3
source/components/selfhostheader.md
View File

@@ -0,0 +1,3 @@
<h1 align="center">[ SelfHosted ] </h1>
<p align="center">Filtered for selfhosted apps</p>

4
source/components/tags.md
View File

@@ -11,6 +11,8 @@
`🟥` - Corporate influence
`🔺` - Commercial
`🧪` - Experimental (Pre-Alpha)
`🚧` - Critically unstable/buggy
@@ -40,4 +42,4 @@
`CLI+` - CLI in addition to GUI
`Windows`, `MacOS`, `Linux`, `Android`, `IOS`, `CLI`, `SelfHost`, `Web`, `VSCode`, `JetBrains`, `Chromium`, `Firefox`, `Plugin`, `Extension`, `N/A`
`Windows`, `MacOS`, `Linux`, `Android`, `IOS`, `CLI`, `SelfHost`, `Web`, `VSCode`, `JetBrains`, `Chromium`, `Firefox`, `Plugin`, `Extension`, `N/A`

3
source/components/windowsheader.md
View File

@@ -0,0 +1,3 @@
<h1 align="center">[ Windows ] </h1>
<p align="center">Filtered for Windows and cross-platform apps</p>

25
source/scripts/mainheader_generator.py Normal file
View File

@@ -0,0 +1,25 @@
import json
def generate_mainheader():
with open("source/data/applications.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.5.2-beta</td>
</tr>
</table>
<h1 align="center">[ definitive-opensource ] </h1>
<p align="center">A 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
if __name__ == "__main__":
generate_mainheader()

9
source/scripts/readme_generator.py
View File

@@ -1,6 +1,7 @@
import os
from tableofcontents_generator import generate_table_of_contents
from contents_generator import generate_contents
from mainheader_generator import generate_mainheader
# List of target platforms
platforms = ["all", "windows", "macos", "linux", "selfhost"]
@@ -17,6 +18,10 @@ header_files = {
def generate_readme_for_platform(platform):
content = ""
header_file = header_files.get(platform, "source/components/header.md")
# Inject mainheader with dynamic project count
if platform == "all":
content += generate_mainheader()
# Inject header (for 'all', use header.md; for others, use the platform-specific header)
with open(header_file, "r", encoding="utf-8") as f:
@@ -30,7 +35,7 @@ def generate_readme_for_platform(platform):
toc_md = generate_table_of_contents()
content += toc_md + "\n"
# Generate the actual list of contents (Markdown list) for the given platform
# Generate the actual markdown list of contents for the given platform
contents_md = generate_contents(platform)
content += contents_md + "\n"
@@ -38,7 +43,7 @@ def generate_readme_for_platform(platform):
with open("source/components/footer.md", "r", encoding="utf-8") as f:
content += f.read() + "\n"
# Write output file; for "all" use README.md, otherwise README-<platform>.md
# Write output file
output_filename = "source/testing/test.md" if platform == "all" else f"readmes/{platform}.md"
with open(output_filename, "w", encoding="utf-8") as f:
f.write(content)

37
source/testing/test.md
View File

@@ -1,14 +1,14 @@
<table align="center">
<tr>
<tr>
<td>🇺🇦 v0.5.2-beta</td>
</tr>
</tr>
</table>
<h1 align="center">[ definitive-opensource ] </h1>
<p align="center"> A definitive list of the best of everything open source</p>
<p align="center">A definitive list of the best of everything open source</p>
<p align="center"><code>Status: Active</code> - <code>Projects: 422</code></p>
<p align="center"><code>Status: Active</code> - <code>Projects: 421</code></p>
> [!TIP]
> Discussions and contributions are welcome! This project is in it's early stages and a lot hasn't been ironed out yet. For more information on [contributing](.github/CONTRIBUTING.md) and [guidelines](resources/dev/GUIDELINES.md) for open-source software submissions, consult their respective pages.
@@ -44,6 +44,31 @@ This list aims to serve as a single centralized location for the best of open so
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 makes refactoring the list format far easier and eliminates typos. This new system also opens the door to
<p>&nbsp;</p>
The project architecture is as follows:
```text
definitive-opensource/
├── assets/
├── readmes/
├── resources/
│ ├── backup/
│ └── dev/
├── source/
│ ├── components/
│ ├── data/
│ ├── scripts/
| └── utils/
│ └── testing/
└── README.md
```
</details>
## Project Status
```css
Active - Active Development
@@ -74,6 +99,8 @@ Abandoned - Development Halted
`🟥` - Corporate influence
`🔺` - Commercial
`🧪` - Experimental (Pre-Alpha)
`🚧` - Critically unstable/buggy
@@ -104,6 +131,7 @@ Abandoned - Development Halted
`CLI+` - CLI in addition to GUI
`Windows`, `MacOS`, `Linux`, `Android`, `IOS`, `CLI`, `SelfHost`, `Web`, `VSCode`, `JetBrains`, `Chromium`, `Firefox`, `Plugin`, `Extension`, `N/A`
## Table of Contents
<details>
@@ -1276,6 +1304,7 @@ Abandoned - Development Halted
| [XPipe](https://github.com/xpipe-io/xpipe) | Your entire server infrastructure at your fingertips | `Cross` | ![GitHub Repo stars](https://img.shields.io/github/stars/xpipe-io/xpipe?style=for-the-badge&label=%20&color=white) |
## Honorable Mentions of Closed-Source Software
Some proprietary software just deserve recognition.
- [Davinci Resolve](https://www.blackmagicdesign.com/products/davinciresolve) - Professional Editing, Color, Effects and Audio Post!