mirror of
https://github.com/GetOpenScript/GitHub.openscript.git
synced 2026-09-18 08:25:42 +00:00
56 lines
2.8 KiB
Markdown
56 lines
2.8 KiB
Markdown
# GitHub OpenScripts
|
|
|
|
Small, independent [OpenScript](https://github.com/GetOpenScript/OpenScript) enhancements for GitHub. Install either script or both.
|
|
|
|
## Scripts
|
|
|
|
### Display Repo Info and File Sizes
|
|
|
|
[`DisplayRepoInfo.os.js`](./DisplayRepoInfo.os.js) adds repository information and file sizes directly to GitHub's interface.
|
|
|
|
- Shows total repository disk usage and repository age in the **About** sidebar.
|
|
- Shows the exact repository creation date and time on hover.
|
|
- Adds human-readable sizes beside files in root and nested directory listings.
|
|
- Handles GitHub SPA navigation without requiring a page refresh.
|
|
- Uses GitHub-native layout, colors, and responsive filename cells.
|
|
- Supports private repositories through an optional `GH_PAT` secret.
|
|
|
|
This script requests repository metadata when the **About** section is rendered and directory contents when a GitHub file listing is rendered. It guards in-progress directory requests to avoid duplicate API calls during DOM updates.
|
|
|
|
### Download GitHub Directory
|
|
|
|
[`DownloadDir.os.js`](./DownloadDir.os.js) adds **Download directory** to the three-dot menu on GitHub directory pages.
|
|
|
|
- Makes no GitHub requests on page load, navigation, or menu opening.
|
|
- Starts all download-related requests only after **Download directory** is clicked.
|
|
- Uses one recursive Git Trees API request for a normal public repository, then retrieves file bytes from `raw.githubusercontent.com` without spending additional REST API quota.
|
|
- Falls back to additional tree requests only when GitHub truncates an unusually large recursive tree response.
|
|
- Downloads private repository files through authenticated Git blob requests.
|
|
- Builds the ZIP locally in the browser with JSZip and preserves the selected directory as its root folder.
|
|
- Handles GitHub SPA navigation and branch names containing slashes.
|
|
|
|
OpenScript downloads and caches the declared JSZip `@require` when the script is saved. It is not downloaded again on every GitHub page.
|
|
|
|
## Installation
|
|
|
|
Each file is a separate OpenScript:
|
|
|
|
1. Open the **OpenScript** extension popup.
|
|
2. Click **+ New**.
|
|
3. Paste the contents of the script you want to install.
|
|
4. Click **save script**.
|
|
5. Repeat for the other script if you want both features.
|
|
|
|
After updating an installed script, save it again and refresh the current GitHub page once. Later GitHub navigation works without refreshing.
|
|
|
|
## Private Repositories
|
|
|
|
Both scripts support a GitHub personal access token stored in OpenScript:
|
|
|
|
1. Create a GitHub token with read access to the required private repositories.
|
|
2. Open OpenScript and select the **Secrets** tab.
|
|
3. Add `GH_PAT` as the key and the token as its value.
|
|
4. Click **+ Add**, then re-save the scripts.
|
|
|
|
The scripts also recognize `GITHUB_PAT`, `GITHUB_TOKEN`, and `PAT`. Tokens are sent only to `api.github.com` and are never included in generated ZIP files.
|