GoldenCheetah Proxy
A small tool that lets web apps access your GoldenCheetah data. It runs on your computer and keeps your data private. Nothing is sent to the cloud.
Installation
You don't need Python or any other programming tools installed. The commands below handle everything automatically.
macOS and Linux: open Terminal (on Mac: press Cmd+Space, type "Terminal", press Enter) and paste:
curl -LsSf uvx.sh/goldencheetah-proxy/install.sh | sh
Windows: open PowerShell (press the Windows key, type "PowerShell", press Enter) and paste:
powershell -ExecutionPolicy ByPass -c "irm https://uvx.sh/goldencheetah-proxy/install.ps1 | iex"
Important: After installing, close your terminal and open a fresh one. This is needed so your terminal picks up the newly installed command.
How to use
1. Enable the GoldenCheetah API
Open GoldenCheetah, then go to:
Settings → General → Integration → Enable API Web Services
2. Start the proxy
Open a terminal (or PowerShell on Windows) and run:
goldencheetah-proxy
You should see:
GoldenCheetah Proxy v0.1.0
Proxy running on http://localhost:12022
Forwarding to GoldenCheetah at http://localhost:12021
Waiting for connections...
Leave this running while you use the web viewer.
3. Open the web viewer
Open goldencheetah-web-viewer/index.html in your browser and click Connect.
The proxy will ask you to approve the website. Click Allow (or type y in the terminal on Linux).
What does the proxy do?
GoldenCheetah has a built-in API that runs on your computer. Browsers can't talk to it directly due to security restrictions (CORS). The proxy sits in between and adds the right headers so your browser can access the data.
Browser → Proxy (localhost:12022) → GoldenCheetah API (localhost:12021)
Your data never leaves your computer.
Options
goldencheetah-proxy --port 9999 # Use a different port (default: 12022)
goldencheetah-proxy --gc-port 5555 # GoldenCheetah API port (default: 12021)
For developers
Source: github.com/SweatStack/goldencheetah-proxy
This project uses uv for development:
git clone git@github.com:SweatStack/goldencheetah-proxy.git
cd goldencheetah-proxy
uv sync # Set up the project
uv run goldencheetah-proxy # Run during development
uv run pytest # Run tests
1 maintainer
Metadata
1 maintainer
Release files for goldencheetah-proxy 0.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| goldencheetah_proxy-0.3.0.tar.gz | 3.9 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| goldencheetah_proxy-0.3.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 9.5 kB
Release files / goldencheetah_proxy-0.3.0.tar.gz
| Download URL | goldencheetah_proxy-0.3.0.tar.gz |
|---|---|
| Size | 3.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a025dd9e8fa68c86000e4f3aec05961c89f68b4ce2421bcce026c67bd7585868
|
|
BLAKE2b-256 checksum How to use checksums |
f588f4807ecb3dd46e0d3a719954b18f0266b1480151ebefbd6ff29a1ed569d3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.6
|
Release files / goldencheetah_proxy-0.3.0-py3-none-any.whl
| Download URL | goldencheetah_proxy-0.3.0-py3-none-any.whl |
|---|---|
| Size | 5.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
95b7b4f67f6a7d31eeea03be779fad0e831ecc226aa9ccf4d582246e680e044e
|
|
BLAKE2b-256 checksum How to use checksums |
b25adaf3b7aed8c8c7fc2f3bf85111cf6e8ebee50159f02e6112668aa8e3ab29
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.6
|
Security for goldencheetah-proxy 0.3.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
