A fast, searchable, categorized desktop GUI for browsing the public-apis directory — built with nothing but the Python standard library (tkinter).

Features

• 🔎 Live search across API name, description, and category
• 🗂️ Category sidebar with live counts, generated straight from the source README
• 🔐 Filter by auth type (No auth / apiKey / OAuth) and HTTPS support
• 🎴 Card-based results grid with clickable links out to each API's docs
• ⚡ Loads data directly from the live public-apis README on GitHub — always up to date
• 🖤 Clean dark theme, zero external dependencies

Screenshot

Add a screenshot of the running app here, e.g. assets/screenshot.png, then reference it: ![screenshot](assets/screenshot.png)

Getting started

Requirements

• Python 3.9+
• tkinter (bundled with most Python installs; on Debian/Ubuntu install with sudo apt install python3-tk if it's missing)

No third-party packages are required to run the app.

Run it

git clone https://github.com/<your-username>/public-apis-explorer.git
cd public-apis-explorer
python3 public_apis_explorer.py

Project structure

public-apis-explorer/
├── public_apis_explorer.py   # the app
├── assets/
│   ├── icon.png / icon_*.png # app logo, various sizes
│   ├── icon.ico              # Windows/favicon icon
│   ├── banner.png            # README banner
│   └── generate_logo.py      # regenerates all of the above (needs Pillow)
├── requirements.txt
├── LICENSE
└── README.md

Logo

The logo is a small vector mark — { } (an API surface) with a single accent dot standing in for an endpoint — on an indigo gradient badge. It's drawn twice: once as a Canvas vector inside the app itself (no image dependency), and once as the PNG/ICO set in assets/ used for the window icon and this README. Regenerate the image assets any time with:

pip install Pillow
python3 assets/generate_logo.py

Contributing

Issues and pull requests are welcome. If you spot a parsing edge case in the public-apis README that trips up parse_readme(), please open an issue with the offending line.

License

MIT