2020-10-12 16:35:17 +03:00
< p align = "center" >
< img src = "https://cdn.svarun.dev/gh/varunsridharan/github-gitea-mirror/banner.jpg" / >
< / p >
2020-10-12 15:24:15 +03:00
Simple Python Script To Mirror Repository / Gist From Github To Gitea
## Why ?
2020-10-12 16:18:03 +03:00
I am a [data hoarder. ](https://www.reddit.com/r/DataHoarder/ )
2020-10-12 15:24:15 +03:00
2020-10-12 16:18:03 +03:00
I am not migrating away from GitHub because I see no reason to: the platform is very useful to me, and I’ d not like to loose it. What I’ m trying to accomplish is a fail-safe in case something happens to GitHub which would make me loose access, be that voluntarily or involuntarily.
2020-10-12 15:24:15 +03:00
2020-10-12 16:18:03 +03:00
## ✅ Requirements
1. Python3 -- `sudo apt-get install python3`
2. [PyGithub ](https://github.com/PyGithub/PyGithub ) -- `pip install PyGithub`
## ⚙️ Installation
### Github Clone
Just run the below cmd in your Gitea server
git clone https://github.com/varunsridharan/github-gitea-mirror
Or you can download the source code and install it where ever you need
## 🚀 Usage
### Github Access Token Scopes
* if you want to mirror private repos then select everything under **Repo** scope
* if you want to mirror public repos then select **repo.public_repo** scope
* if you want to mirror secret Gists then select **gist** scope
### First make sure you have updated the `config.json`
| Option | Description |
| --- | --- |
| `github.username` | Your Github Username |
| `github.accesstoken` | Your Github Account's Personal Access Token |
| - | - |
| `gitea.host` | Selfhosted Gitea URL without `/` at the end |
| `gitea.accesstoken` | Your Personal Access Token |
| `gitea.username` | Account User Name |
| `gitea.gist.prefix` | Custom Prefix For Repository When Mirroring Gists |
| `gitea.gist.surfix` | Custom Prefix For Repository When Mirroring Gists |
| - | - |
| `repomap` | Remap A Repository To Diff User |
| `gistsSource` | set to true to mirror all Gists Created By You|
| `gistsStared` | set to true to mirror all Gists Stared By You|
| `repositoryStared` | set to true to mirror all Repository Stared By You |
| `repositorySource` | set to true to mirror all Repository Created By You |
| `repositoryForked` | set to true to mirror all Repository Forked By You |
2020-10-26 05:07:39 +03:00
| - | - |
| `local_cache.enabled` | Set to **true** to store all repostiory slugs from gitea as json |
| `local_cache.file_path` | Custom Path to store json file |
> Local Cache can come handly when running this script via cron
> which reduces api request your selfhosted gitea instance
2020-10-12 16:18:03 +03:00
### Run cmd & Wait
$ python3 mirror.py
## Cron Setup
1. Run `crontab -e`
2. `mkdir $HOME/mirrorLogs -p`
2020-10-25 04:34:03 +03:00
3. `/usr/bin/python3 $HOME/github-to-gitea-mirror/mirror.py > $HOME/mirrorLogs/` date +\%Y-\%m-\%d-\%H-\%M-\%S`.log 2>& 1`
2020-10-12 16:18:03 +03:00
---
## 📝 Changelog
All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog ](https://keepachangelog.com/en/1.0.0/ ),
and this project adheres to [Semantic Versioning ](https://semver.org/spec/v2.0.0.html ).
[Checkout CHANGELOG.md ](/CHANGELOG.md )
## 🤝 Contributing
If you would like to help, please take a look at the list of [issues ](issues/ ).
## 💰 Sponsor
[I][twitter] fell in love with open-source in 2013 and there has been no looking back since! You can read more about me [here][website].
If you, or your company, use any of my projects or like what I’ m doing, kindly consider backing me. I'm in this for the long run.
- ☕ How about we get to know each other over coffee? Buy me a cup for just [**$9.99**][buymeacoffee]
- ☕️☕️ How about buying me just 2 cups of coffee each month? You can do that for as little as [**$9.99**][buymeacoffee]
- 🔰 We love bettering open-source projects. Support 1-hour of open-source maintenance for [**$24.99 one-time?**][paypal]
- 🚀 Love open-source tools? Me too! How about supporting one hour of open-source development for just [**$49.99 one-time ?**][paypal]
## 📜 License & Conduct
2020-10-25 04:32:19 +03:00
- [**MIT** ](LICENSE ) © [Varun Sridharan ](website )
2020-10-12 16:18:03 +03:00
- [Code of Conduct ](code-of-conduct.md )
## 📣 Feedback
- ⭐ This repository if this project helped you! :wink:
- Create An [🔧 Issue ](issues/ ) if you need help / found a bug
## Connect & Say 👋
- **Follow** me on [👨💻 Github][github] and stay updated on free and open-source software
- **Follow** me on [🐦 Twitter][twitter] to get updates on my latest open source projects
- **Message** me on [📠 Telegram][telegram]
- **Follow** my pet on [Instagram][sofythelabrador] for some _dog-tastic_ updates!
---
< p align = "center" >
< i > Built With ♥ By < a href = "https://sva.onl/twitter" target = "_blank" rel = "noopener noreferrer" > Varun Sridharan< / a > 🇮🇳 < / i >
< / p >
---
<!-- Personl Links -->
[paypal]: https://sva.onl/paypal
[buymeacoffee]: https://sva.onl/buymeacoffee
[sofythelabrador]: https://www.instagram.com/sofythelabrador/
[github]: https://sva.onl/github/
[twitter]: https://sva.onl/twitter/
[telegram]: https://sva.onl/telegram/
[email]: https://sva.onl/email
[website]: https://sva.onl/website/