github-star-exporter - Export (your) GitHub starred repositories to a JSON file

A simple CLI to archive your GitHub stars.

Overview

• Overview
• Prerequisites
• Installation
  • Clone the Repository
  • Navigate to the Directory
  • Install the Package
• Usage
• Example
• Support
• Credits
• Star History
• License

Prerequisites

• Python 3.6 or higher
• requests, for making HTTP requests to the GitHub API
• colorama, for colored terminal output on all platforms
• A GitHub Personal Access Token (PAT). The PAT must have the read:user scope enabled.

Installation

1. First, clone the repo:

• git clone https://github.com/ree-verse/github-star-exporter.git

2. Then, go to the project folder:

• cd github-star-exporter

3. Finally, you can install it locally with the following command:

• pip install .

Note

For development, you can also install it in editable mode: pip install -e .

Usage

To run with the authenticated user:

github-star-exporter --token TOKEN

To target a specific user:

github-star-exporter --token TOKEN --user octocat

To select a specific output path:

github-star-exporter --token TOKEN --output /path/to/output.json

Here are all available commands:

$ github-star-exporter --help
usage: github-star-exporter [-h] [-t TOKEN] [-u USER] [-o OUTPUT] [-v]

Export (your) GitHub starred repositories to a JSON file.

options:
  -h, --help            show this help message and exit
  -t TOKEN, --token TOKEN
                        GitHub access token (needs read:user permission)
  -u USER, --user USER  Target GitHub username (default: authenticated user)
  -o OUTPUT, --output OUTPUT
                        Output JSON file (default: output.json)
  -v, --version         Version information

Tip

You can also export all repositories owned by the user instead of starred repos. Just change the API endpoint in the code from /starred to /repos.

Example

Example output file:

[
    {
        "name": "ReXOR",
        "full_name": "Ree-verse/ReXOR",
        "private": false,
        "html_url": "https://github.com/Ree-verse/ReXOR",
        "description": "Cross-platform Rust library with CLI app implementing XOR encryption/decryption",
        "fork": false,
        "homepage": "https://crates.io/crates/ReXOR",
        "language": "Rust",
        "forks_count": 0,
        "stargazers_count": 1,
        "topics": [
            "cli",
            "decryption",
            "encryption",
            "security",
            "xor"
        ],
        "archived": false,
        "visibility": "public",
        "owner": "Ree-verse",
        "pushed_at": "2025-10-22T11:58:36Z",
        "created_at": "2025-10-22T09:30:23Z",
        "updated_at": "2025-10-22T11:58:39Z",
        "license_name": "MIT License"
    }
]

Support

If you have questions, suggestions, or want to hang out with other developers, join my Discord server: Ree-verse GitHub Support.

Credits

This project was inspired by JeffCarpenter/export-stars. Many thanks to Jeff Carpenter for the inspiration.

Star History

License

Released under the MIT License © 2025 Ree-verse.