{"id":20597434,"url":"https://github.com/loveduckie/github-stars-export","last_synced_at":"2026-04-28T00:31:54.436Z","repository":{"id":256638463,"uuid":"855999408","full_name":"LoveDuckie/github-stars-export","owner":"LoveDuckie","description":"A simple Python tool for exporting starred GitHub projects to a Notion database.","archived":false,"fork":false,"pushed_at":"2024-11-14T15:51:19.000Z","size":84,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-06T15:19:57.001Z","etag":null,"topics":["github-stars","github-stars-export","notion","notion-database","python","python-tool"],"latest_commit_sha":null,"homepage":"https://lucshelton.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LoveDuckie.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-11T20:09:25.000Z","updated_at":"2025-02-23T10:45:48.000Z","dependencies_parsed_at":"2025-06-22T07:33:15.569Z","dependency_job_id":null,"html_url":"https://github.com/LoveDuckie/github-stars-export","commit_stats":null,"previous_names":["loveduckie/github-stars-export"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/LoveDuckie/github-stars-export","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LoveDuckie%2Fgithub-stars-export","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LoveDuckie%2Fgithub-stars-export/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LoveDuckie%2Fgithub-stars-export/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LoveDuckie%2Fgithub-stars-export/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LoveDuckie","download_url":"https://codeload.github.com/LoveDuckie/github-stars-export/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LoveDuckie%2Fgithub-stars-export/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261255849,"owners_count":23131474,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["github-stars","github-stars-export","notion","notion-database","python","python-tool"],"created_at":"2024-11-16T08:22:28.388Z","updated_at":"2026-04-28T00:31:49.418Z","avatar_url":"https://github.com/LoveDuckie.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GitHub Stars Export\n\n## Overview\n\nGitHub Stars Export is a Python tool that exports your starred repositories from GitHub to a Notion database. It allows you to easily organize and manage the repositories you have starred, providing a way to store metadata in Notion for easy searching and categorization.\n\n## Features\n\n- Export starred repositories from your GitHub account.\n- Save repository information, such as name, URL, and description, to a Notion database.\n- Uses environment variables for secure configuration.\n\n## Requirements\n\n- Python 3.8+\n- Notion API Key\n- GitHub Personal Access Token\n\n## Installation\n\n1. Clone the repository:\n\n   ```sh\n   git clone https://github.com/your-username/github-stars-export.git\n   cd github-stars-export\n   ```\n\n2. Install dependencies using Poetry:\n\n   ```sh\n   poetry install\n   ```\n\n3. Create a `.env` file to store your API keys:\n\n   ```sh\n   touch .env\n   ```\n\n   Add the following keys to your `.env` file:\n\n   ```ini\n   GITHUB_API_TOKEN=your_github_token\n   NOTION_API_TOKEN=your_notion_token\n   ```\n\n## Usage\n\nTo export your GitHub starred repositories to Notion, run the following command:\n\n```sh\npoetry run python -m github_stars_export\n```\n\nThis command will authenticate using the provided GitHub and Notion tokens and start exporting starred repositories to your Notion database.\n\n### Examples\n\n1. **Basic Export Command**\n\n   To export your GitHub starred repositories to a Notion database, you can run the following command with the required options:\n\n   ```sh\n   poetry run python -m github_stars_export --github-api-token YOUR_GITHUB_API_TOKEN --notion-api-token YOUR_NOTION_API_TOKEN --notion-database-id YOUR_NOTION_DATABASE_ID\n   ```\n\n   Alternatively, if you have set the required environment variables in your `.env` file (`GITHUB_API_TOKEN`, `NOTION_API_TOKEN`, `NOTION_DATABASE_ID`), you can simplify the command:\n\n   ```sh\n   poetry run python -m github_stars_export\n   ```\n\n2. **Using Environment Variables**\n\n   You can export the starred repositories without specifying the tokens explicitly in the command if you have the environment variables set:\n\n   ```sh\n   export GITHUB_API_TOKEN=your_github_token\n   export NOTION_API_TOKEN=your_notion_token\n   export NOTION_DATABASE_ID=your_notion_database_id\n\n   poetry run python -m github_stars_export\n   ```\n\n3. **Help Command**\n\n   To view all the available options and get help with usage:\n\n   ```sh\n   poetry run python -m github_stars_export --help\n   ```\n\n   This will display information about required options such as `--github-api-token`, `--notion-api-token`, and `--notion-database-id`.\n\n### Command-line Options\n\n- `--github-api-token` (required): The GitHub API token used to access your starred repositories.\n- `--notion-api-token` (required): The Notion API token used to connect to your Notion workspace.\n- `--notion-database-id` (required): The ID of the Notion database where the starred repositories will be saved.\n\nThese examples show how to configure and run the export using the command-line interface provided by the tool, either by specifying the tokens directly or by using environment variables.\n\n\n## Scripts\n\nThe repository includes several helper scripts:\n\n- `build.sh`: Builds the project for distribution.\n- `format.sh`: Formats the code using the preferred code style.\n- `lint.sh`: Runs linters to ensure code quality.\n\n## Configuration\n\nThe project uses `pyproject.toml` to manage dependencies and configuration for tools like linters and formatters. It also includes a `.pylintrc` for customizing `pylint` behavior.\n\n## Development\n\nFor local development:\n\n1. Install dependencies:\n\n   ```sh\n   poetry install\n   ```\n\n2. Run the code formatter:\n\n   ```sh\n   ./format.sh\n   ```\n\n3. Run the linter:\n\n   ```sh\n   ./lint.sh\n   ```\n\n## Contributing\n\nContributions are welcome! Feel free to open issues or submit pull requests.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more information.\n\n## Contact\n\nIf you have any questions or suggestions, feel free to reach out to the repository maintainer.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Floveduckie%2Fgithub-stars-export","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Floveduckie%2Fgithub-stars-export","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Floveduckie%2Fgithub-stars-export/lists"}