# Difference Between README.md and MOBILE.md in the Awesome Free Apps Repository > Discover the difference between README.md and MOBILE.md in the Awesome Free Apps repository. Learn which file lists desktop apps and which focuses on mobile applications for your platform. - Repository: [Axorax/awesome-free-apps](https://github.com/Axorax/awesome-free-apps) - Tags: deep-dive - Published: 2026-05-26 --- **The fundamental distinction lies in platform targeting:** [`README.md`](https://github.com/Axorax/awesome-free-apps/blob/main/README.md) serves as a comprehensive catalog for Windows, macOS, and Linux desktop applications, while [`MOBILE.md`](https://github.com/Axorax/awesome-free-apps/blob/main/MOBILE.md) exclusively curates Android and iOS apps, although both files maintain identical categorical hierarchies. The **Axorax/awesome-free-apps** repository maintains two parallel master lists to separate desktop and mobile ecosystems. Understanding the difference between [`README.md`](https://github.com/Axorax/awesome-free-apps/blob/main/README.md) and [`MOBILE.md`](https://github.com/Axorax/awesome-free-apps/blob/main/MOBILE.md) ensures developers and users navigate to the correct platform-specific software collection without sifting through incompatible entries. ## Platform Targeting and Device Compatibility Both files organize software under identical high-level headings—such as `## Audio`, `## Browsers`, and `## Communication`—but the entries within each section target entirely different operating systems. ### Desktop Catalog in README.md The primary [`README.md`](https://github.com/Axorax/awesome-free-apps/blob/main/README.md) focuses on **desktop-grade applications** compatible with Windows 🪟, macOS 🍎, and Linux 🐧. Near the top of the file (lines 5–7), it provides a direct link to the mobile alternative: `[Mobile version](MOBILE.md)`. This file aggregates native PC software such as Foobar2000, VLC, and Visual Studio Code, and references filter files oriented around desktop OSes such as [`filter/windows-only.md`](https://github.com/Axorax/awesome-free-apps/blob/main/filter/windows-only.md) and [`filter/open-source-only.md`](https://github.com/Axorax/awesome-free-apps/blob/main/filter/open-source-only.md). ### Mobile Catalog in MOBILE.md Conversely, [`MOBILE.md`](https://github.com/Axorax/awesome-free-apps/blob/main/MOBILE.md) delivers a **compact smartphone and tablet catalog** for Android 🤖 and iOS 🍎. Its header (lines 5–7) links back to the desktop version via `[PC version](README.md)`. Instead of desktop binaries, it lists mobile-optimized alternatives such as VLC for Mobile, Foobar2000 mobile, and Termux. The file points to mobile-specific filters including [`filter/android-only.md`](https://github.com/Axorax/awesome-free-apps/blob/main/filter/android-only.md), [`filter/iOS-only.md`](https://github.com/Axorax/awesome-free-apps/blob/main/filter/iOS-only.md), and [`filter/open-source-mobile-only.md`](https://github.com/Axorax/awesome-free-apps/blob/main/filter/open-source-mobile-only.md). ## Iconography and Visual Classification Each file employs a distinct emoji legend to signal platform compatibility at a glance, defined in the header sections (lines 8–12). - **README.md**: Uses 🪟 (Windows), 🍎 (macOS), 🐧 (Linux), 🟢 (open-source), and ⭐ (recommended) - **MOBILE.md**: Uses 🤖 (Android), 🍎 (iOS), 🟢 (open-source), and ⭐ (recommended) Both files reserve 🟢 and ⭐ for open-source and recommended designations respectively, ensuring consistency in software quality signaling across platforms. ## Content Volume and Maintenance Strategy The desktop [`README.md`](https://github.com/Axorax/awesome-free-apps/blob/main/README.md) significantly outweighs its mobile counterpart in size, as it must cover three distinct operating systems with extensive software ecosystems. By contrast, [`MOBILE.md`](https://github.com/Axorax/awesome-free-apps/blob/main/MOBILE.md) remains comparatively concise at approximately 380 lines, covering only Android and iOS. This separation allows contributors to update platform-specific entries without cluttering the master list, maintaining clean version control history for each ecosystem. ## Practical Usage and File Access To inspect these files locally and understand their structural differences, clone the repository and examine the content directly: ```bash # Clone the repository git clone https://github.com/Axorax/awesome-free-apps.git cd awesome-free-apps # View the desktop catalog less README.md # View the mobile catalog (approx. 380 lines) less MOBILE.md ``` When cross-referencing between platforms in your own documentation, use the relative markdown links implemented in the headers: ```markdown [Mobile version](MOBILE.md) [PC version](README.md) ``` Both files utilize the repository logo stored at `.github/afa.png` and maintain synchronized category headings, ensuring users experience predictable navigation regardless of which platform list they consult. ## Summary - **Platform Scope**: [`README.md`](https://github.com/Axorax/awesome-free-apps/blob/main/README.md) targets Windows, macOS, and Linux; [`MOBILE.md`](https://github.com/Axorax/awesome-free-apps/blob/main/MOBILE.md) targets Android and iOS. - **Icon Differences**: Desktop uses 🪟/🐧; mobile uses 🤖, with shared 🟢/⭐ badges. - **Filter Structure**: Desktop references [`filter/windows-only.md`](https://github.com/Axorax/awesome-free-apps/blob/main/filter/windows-only.md) and [`filter/open-source-only.md`](https://github.com/Axorax/awesome-free-apps/blob/main/filter/open-source-only.md); mobile uses [`filter/android-only.md`](https://github.com/Axorax/awesome-free-apps/blob/main/filter/android-only.md), [`filter/iOS-only.md`](https://github.com/Axorax/awesome-free-apps/blob/main/filter/iOS-only.md), and [`filter/open-source-mobile-only.md`](https://github.com/Axorax/awesome-free-apps/blob/main/filter/open-source-mobile-only.md). - **Cross Links**: Each file links to the other in its header section (lines 5–7). - **Maintenance**: Parallel lists prevent cross-platform clutter and simplify contribution workflows. ## Frequently Asked Questions ### Can I submit a mobile application to README.md? No. The **Awesome Free Apps** repository strictly separates platforms to maintain clarity. Submit Android and iOS applications exclusively to [`MOBILE.md`](https://github.com/Axorax/awesome-free-apps/blob/main/MOBILE.md), while Windows, macOS, and Linux software belongs in [`README.md`](https://github.com/Axorax/awesome-free-apps/blob/main/README.md). This bifurcation ensures users browsing for desktop tools do not encounter incompatible mobile-only entries. ### Do both files share the same category structure? Yes. Both [`README.md`](https://github.com/Axorax/awesome-free-apps/blob/main/README.md) and [`MOBILE.md`](https://github.com/Axorax/awesome-free-apps/blob/main/MOBILE.md) implement identical hierarchical headings—such as `## Audio`, `## Browsers`, and `## Communication`—so users experience consistent navigation. However, the specific applications listed under each heading differ to match platform capabilities and availability. ### Why are the filter files separated into desktop and mobile versions? The repository maintains distinct filter files—like [`filter/windows-only.md`](https://github.com/Axorax/awesome-free-apps/blob/main/filter/windows-only.md) versus [`filter/android-only.md`](https://github.com/Axorax/awesome-free-apps/blob/main/filter/android-only.md)—to support platform-specific sorting without conditional logic complexity. This architecture allows the GitHub interface and local markdown viewers to render clean, platform-filtered lists by referencing dedicated files rather than parsing conditional tags within a single massive document.