mirror of
https://github.com/kevinveenbirkenbach/github-to-gitea-mirror.git
synced 2025-04-01 17:04:16 +02:00
Update README.md
This commit is contained in:
parent
dc1b5c7e74
commit
8a55e7926f
72
README.md
72
README.md
@ -1,36 +1,68 @@
|
||||
# github-to-gitea-mirror
|
||||
# GitHub to Gitea Mirror 🚀🔄
|
||||
|
||||
Effortlessly synchronize your GitHub repositories to Gitea. `github-to-gitea-mirror` seamlessly detects GitHub repositories not present on Gitea and mirrors them, ensuring your repositories are consistent across both platforms.
|
||||
[](./LICENSE)
|
||||
[](https://www.python.org/)
|
||||
[](https://github.com/kevinveenbirkenbach/github-to-gitea-mirror/stargazers)
|
||||
|
||||
## 🚀 Setup & Usage
|
||||
**GitHub to Gitea Mirror** automatically detects repositories on GitHub that are not yet mirrored on Gitea and mirrors them—ensuring that your codebase remains consistent across both platforms.
|
||||
|
||||
## 🔧 Features
|
||||
|
||||
- **Auto-Detection:** Identifies GitHub repos missing on Gitea.
|
||||
- **Seamless Mirroring:** Automatically mirrors repositories using the Gitea API.
|
||||
- **Secure Authentication:** Utilizes environment variables and tokens for secure API access.
|
||||
|
||||
## 🚀 Installation
|
||||
|
||||
Install **GitHub to Gitea Mirror** via [Kevin's Package Manager](https://github.com/kevinveenbirkenbach/package-manager):
|
||||
|
||||
1. Install required packages:
|
||||
```bash
|
||||
pip install python-dotenv requests
|
||||
pkgman install gigimi
|
||||
```
|
||||
|
||||
2. Create a `.env` file in your project directory with the following:
|
||||
```bash
|
||||
GITHUB_USER=your_github_username
|
||||
GITEA_USER=your_gitea_username
|
||||
GITEA_TOKEN=your_gitea_token
|
||||
```
|
||||
## 🛠️ Setup & Usage
|
||||
|
||||
3. Run the script:
|
||||
```bash
|
||||
python your_script_name.py
|
||||
```
|
||||
1. **Install Required Packages:**
|
||||
|
||||
If you haven't already, install the required Python packages:
|
||||
|
||||
```bash
|
||||
pip install python-dotenv requests
|
||||
```
|
||||
|
||||
2. **Create a `.env` File:**
|
||||
|
||||
In your project directory, create a `.env` file with the following content:
|
||||
|
||||
```bash
|
||||
GITHUB_USER=your_github_username
|
||||
GITEA_USER=your_gitea_username
|
||||
GITEA_TOKEN=your_gitea_token
|
||||
```
|
||||
|
||||
3. **Run the Script:**
|
||||
|
||||
Execute the script to start mirroring:
|
||||
|
||||
```bash
|
||||
python main.py
|
||||
```
|
||||
|
||||
## 🙌 Acknowledgements
|
||||
|
||||
- This script was developed with guidance from [Chat GPT](https://chat.openai.com/share/b62cabf7-ccc5-471f-89bc-7c272bbb4ec5).
|
||||
- Developed with guidance from [ChatGPT](https://chat.openai.com/).
|
||||
- Inspired by the need to maintain repository consistency across platforms.
|
||||
|
||||
## 🖋️ Author
|
||||
|
||||
**Kevin Veen-Birkenbach**
|
||||
- 📧 [kevin@veen.world](mailto:kevin@veen.world)
|
||||
- 🌐 [www.veen.world](https://www.veen.world/)
|
||||
**Kevin Veen-Birkenbach**
|
||||
- 📧 [kevin@veen.world](mailto:kevin@veen.world)
|
||||
- 🌐 [https://www.veen.world/](https://www.veen.world/)
|
||||
|
||||
## 📜 License
|
||||
|
||||
Licensed under the GNU Affero General Public License v3.0. Please refer to the `LICENSE` file for complete details.
|
||||
This project is licensed under the GNU Affero General Public License v3.0. Please refer to the [LICENSE](./LICENSE) file for details.
|
||||
|
||||
---
|
||||
|
||||
Happy mirroring! 🎉🔄
|
||||
|
Loading…
x
Reference in New Issue
Block a user