diff --git a/assets/osi_symbol.webp b/assets/osi_symbol.webp new file mode 100644 index 0000000..5a0eeb5 Binary files /dev/null and b/assets/osi_symbol.webp differ diff --git a/assets/readme.md b/assets/readme.md deleted file mode 100644 index 8b13789..0000000 --- a/assets/readme.md +++ /dev/null @@ -1 +0,0 @@ - diff --git a/readmes/linux.md b/readmes/linux.md index 9028d41..be37a57 100644 --- a/readmes/linux.md +++ b/readmes/linux.md @@ -1,4 +1,7 @@ +

[ Linux ]

+

Filtered for Linux and cross-platform apps

+ ## 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
@@ -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! diff --git a/readmes/macos.md b/readmes/macos.md index 57c5d6f..ae91d7d 100644 --- a/readmes/macos.md +++ b/readmes/macos.md @@ -1,4 +1,7 @@ +

[ MacOS ]

+

Filtered for MacOS and cross-platform apps

+ ## 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
@@ -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! diff --git a/readmes/selfhost.md b/readmes/selfhost.md index 87b7965..f63cae5 100644 --- a/readmes/selfhost.md +++ b/readmes/selfhost.md @@ -1,4 +1,7 @@ +

[ SelfHosted ]

+

Filtered for selfhosted apps

+ ## 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
@@ -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! diff --git a/readmes/windows.md b/readmes/windows.md index 42699fd..968a1b5 100644 --- a/readmes/windows.md +++ b/readmes/windows.md @@ -1,4 +1,7 @@ +

[ Windows ]

+

Filtered for Windows and cross-platform apps

+ ## 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
@@ -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! diff --git a/source/components/footer.md b/source/components/footer.md index 09ebc03..97445d7 100644 --- a/source/components/footer.md +++ b/source/components/footer.md @@ -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! diff --git a/source/components/header.md b/source/components/header.md index e889c52..1eb7e16 100644 --- a/source/components/header.md +++ b/source/components/header.md @@ -1,15 +1,4 @@ - - - - -
πŸ‡ΊπŸ‡¦ v0.5.2-beta
- -

[ definitive-opensource ]

-

A definitive list of the best of everything open source

- -

Status: Active - Projects: 422

- > [!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.
+
+ How The List Works
+ + 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. +

 

+ 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 +

 

+ The project architecture is as follows: + ```text + definitive-opensource/ + β”œβ”€β”€ assets/ + β”œβ”€β”€ readmes/ + β”œβ”€β”€ resources/ + β”‚ β”œβ”€β”€ backup/ + β”‚ └── dev/ + β”œβ”€β”€ source/ + β”‚ β”œβ”€β”€ components/ + β”‚ β”œβ”€β”€ data/ + β”‚ β”œβ”€β”€ scripts/ + | └── utils/ + β”‚ └── testing/ + └── README.md + ``` +
+ ## Project Status ```css Active - Active Development diff --git a/source/components/linuxheader.md b/source/components/linuxheader.md index e69de29..8b63825 100644 --- a/source/components/linuxheader.md +++ b/source/components/linuxheader.md @@ -0,0 +1,3 @@ + +

[ Linux ]

+

Filtered for Linux and cross-platform apps

diff --git a/source/components/macosheader.md b/source/components/macosheader.md index e69de29..5279545 100644 --- a/source/components/macosheader.md +++ b/source/components/macosheader.md @@ -0,0 +1,3 @@ + +

[ MacOS ]

+

Filtered for MacOS and cross-platform apps

diff --git a/source/components/selfhostheader.md b/source/components/selfhostheader.md index e69de29..cc758ac 100644 --- a/source/components/selfhostheader.md +++ b/source/components/selfhostheader.md @@ -0,0 +1,3 @@ + +

[ SelfHosted ]

+

Filtered for selfhosted apps

diff --git a/source/components/tags.md b/source/components/tags.md index f7ca52d..afd4afb 100644 --- a/source/components/tags.md +++ b/source/components/tags.md @@ -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` \ No newline at end of file +`Windows`, `MacOS`, `Linux`, `Android`, `IOS`, `CLI`, `SelfHost`, `Web`, `VSCode`, `JetBrains`, `Chromium`, `Firefox`, `Plugin`, `Extension`, `N/A` diff --git a/source/components/windowsheader.md b/source/components/windowsheader.md index e69de29..1f9e93a 100644 --- a/source/components/windowsheader.md +++ b/source/components/windowsheader.md @@ -0,0 +1,3 @@ + +

[ Windows ]

+

Filtered for Windows and cross-platform apps

diff --git a/source/scripts/mainheader_generator.py b/source/scripts/mainheader_generator.py new file mode 100644 index 0000000..2fc2c86 --- /dev/null +++ b/source/scripts/mainheader_generator.py @@ -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""" + + + + +
πŸ‡ΊπŸ‡¦ v0.5.2-beta
+ +

[ definitive-opensource ]

+

A definitive list of the best of everything open source

+ +

Status: Active - Projects: {project_count}

+""" + + return header_content + +if __name__ == "__main__": + generate_mainheader() diff --git a/source/scripts/readme_generator.py b/source/scripts/readme_generator.py index 7be5691..39207fa 100644 --- a/source/scripts/readme_generator.py +++ b/source/scripts/readme_generator.py @@ -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-.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) diff --git a/source/testing/test.md b/source/testing/test.md index 99c22ce..06e28c4 100644 --- a/source/testing/test.md +++ b/source/testing/test.md @@ -1,14 +1,14 @@ - + - +
πŸ‡ΊπŸ‡¦ v0.5.2-beta

[ definitive-opensource ]

-

A definitive list of the best of everything open source

+

A definitive list of the best of everything open source

-

Status: Active - Projects: 422

+

Status: Active - Projects: 421

> [!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.
+
+ How The List Works
+ + 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. +

 

+ 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 +

 

+ The project architecture is as follows: + ```text + definitive-opensource/ + β”œβ”€β”€ assets/ + β”œβ”€β”€ readmes/ + β”œβ”€β”€ resources/ + β”‚ β”œβ”€β”€ backup/ + β”‚ └── dev/ + β”œβ”€β”€ source/ + β”‚ β”œβ”€β”€ components/ + β”‚ β”œβ”€β”€ data/ + β”‚ β”œβ”€β”€ scripts/ + | └── utils/ + β”‚ └── testing/ + └── README.md + ``` +
+ ## 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
@@ -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!