# ovmvo/freesub architecture

> Architecture diagram of the GitHub repository ovmvo/freesub, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ovmvo/freesub
- Repository: https://github.com/ovmvo/freesub

## Overview

FreeSub is a repository of publicly distributed proxy-subscription files. Users fetch either a stable Mihomo subscription, documented as updated every eight hours, or a latest subscription, documented as updated every two hours under a changing filename. The README identifies the published files and cadence, but the available evidence does not show how subscriptions are generated or refreshed; the raw files’ roles and relationships are therefore omitted.

Main entry points: [`sub/permanent/mihomo.yaml`](https://github.com/ovmvo/freesub/blob/main/sub/permanent/mihomo.yaml) (Permanent feed), [`sub/latest/52092611.yaml`](https://github.com/ovmvo/freesub/blob/main/sub/latest/52092611.yaml) (Latest feed)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_subscriptions["Subscriptions"]
  node_permanent["Permanent feed<br/>[mihomo.yaml]"]
  node_latest["Latest feed<br/>[52092611.yaml]"]
end

node_user(("Subscription user"))

node_user -->|"fetches"| node_permanent
node_user -->|"fetches"| node_latest

click node_permanent "https://github.com/ovmvo/freesub/blob/main/sub/permanent/mihomo.yaml"
click node_latest "https://github.com/ovmvo/freesub/blob/main/sub/latest/52092611.yaml"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_permanent,node_latest,node_user toneBlue
```

## Components

### Subscriptions

- [Permanent feed](https://github.com/ovmvo/freesub/blob/main/sub/permanent/mihomo.yaml): `sub/permanent/mihomo.yaml`
- [Latest feed](https://github.com/ovmvo/freesub/blob/main/sub/latest/52092611.yaml): `sub/latest/52092611.yaml`

### Other components

- **Subscription user**

## Connections

- Subscription user → Permanent feed: fetches
- Subscription user → Latest feed: fetches