mirror of
				https://github.com/kevinveenbirkenbach/github-to-gitea-mirror.git
				synced 2025-11-04 03:48:13 +00:00 
			
		
		
		
	Update README.md
This commit is contained in:
		
							
								
								
									
										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! 🎉🔄
 | 
			
		||||
 
 | 
			
		||||
		Reference in New Issue
	
	Block a user