[GH-ISSUE #246] Feature Request: GitHub Stars - Lists support #722

New Issue

GiteaMirror · 2026-04-16T02:42:51-05:00

GiteaMirror commented

2026-04-16 02:42:51 -05:00

Originally created by @clement-deltel on GitHub (Mar 22, 2026).
Original GitHub issue: https://github.com/RayLabsHQ/gitea-mirror/issues/246

Originally assigned to: @arunavo4 on GitHub.

Hi gitea-mirror development team,

I am submitting this issue as I think that it would be interesting to support the following. I personally amass a ton of repos and star them for future reference, keep track of what I have running in my homelab, of what I have installed on my workstation, etc. In that matter and for better organization, I created some lists of starred repos. Here is what it looks like within GitHub interface:

I would like the possibility to mirror not all my starred repos but only the ones from the lists selected, let's say. For instance, I would like to mirror everything from the lists "homelab" and "dottools" but not "ideas" as it serves a dump for all the things that I find interesting but will not necessarily use or want to keep a copy of. In terms of configuration, it could follow the guidelines:

MIRROR_STARRED: true
MIRROR_STARRED_LISTS:
- if empty, mirror all the starred repos
- otherwise, a comma-separated list of the list names

Thank you in advance for considering my request!

Originally created by @clement-deltel on GitHub (Mar 22, 2026). Original GitHub issue: https://github.com/RayLabsHQ/gitea-mirror/issues/246 Originally assigned to: @arunavo4 on GitHub. Hi gitea-mirror development team, I am submitting this issue as I think that it would be interesting to support the following. I personally amass a ton of repos and star them for future reference, keep track of what I have running in my homelab, of what I have installed on my workstation, etc. In that matter and for better organization, I created some lists of starred repos. Here is what it looks like within GitHub interface: <img width="913" height="505" alt="Image" src="https://github.com/user-attachments/assets/ee010f2c-eab0-4bbf-8240-6e139fddf76f" /> I would like the possibility to mirror not all my starred repos but only the ones from the lists selected, let's say. For instance, I would like to mirror everything from the lists "homelab" and "dottools" but not "ideas" as it serves a dump for all the things that I find interesting but will not necessarily use or want to keep a copy of. In terms of configuration, it could follow the guidelines: - MIRROR_STARRED: true - MIRROR_STARRED_LISTS: - if empty, mirror all the starred repos - otherwise, a comma-separated list of the list names Thank you in advance for considering my request!

GiteaMirror added the enhancement label 2026-04-16 02:42:51 -05:00

GiteaMirror closed this issue

2026-04-16 02:42:51 -05:00

GiteaMirror commented

2026-04-16 02:42:52 -05:00

@arunavo4 commented on GitHub (Mar 23, 2026):

@clement-deltel Implemented in PR #247 and ready for testing with:

ghcr.io/raylabshq/gitea-mirror:pr-247

What’s included

Env var support

MIRROR_STARRED_LISTS (comma-separated list names), e.g.:
- MIRROR_STARRED=true
- MIRROR_STARRED_LISTS=homelab,dottools
If MIRROR_STARRED_LISTS is empty/unset, behavior remains all starred repos.
This is only used when MIRROR_STARRED=true.

UI support

In Configuration → Connections → GitHub Configuration → Repository Selection:
- Enable Mirror starred repositories
- Use Star Lists (optional) selector (searchable multi-select)
- You can also add custom list names manually

Quick test

Use the PR image:

docker pull ghcr.io/raylabshq/gitea-mirror:pr-247

Then run with your normal env plus:

MIRROR_STARRED=true
MIRROR_STARRED_LISTS=<your-list-1>,<your-list-2>

You can verify in UI by selecting the same lists in the new Star Lists (optional) control and running import/sync.

@arunavo4 commented on GitHub (Mar 23, 2026): @clement-deltel Implemented in [PR #247](https://github.com/RayLabsHQ/gitea-mirror/pull/247) and ready for testing with: `ghcr.io/raylabshq/gitea-mirror:pr-247` ### What’s included 1. **Env var support** - `MIRROR_STARRED_LISTS` (comma-separated list names), e.g.: - `MIRROR_STARRED=true` - `MIRROR_STARRED_LISTS=homelab,dottools` - If `MIRROR_STARRED_LISTS` is empty/unset, behavior remains **all starred repos**. - This is only used when `MIRROR_STARRED=true`. 2. **UI support** - In **Configuration → Connections → GitHub Configuration → Repository Selection**: - Enable **Mirror starred repositories** - Use **Star Lists (optional)** selector (searchable multi-select) - You can also add custom list names manually ### Quick test Use the PR image: `docker pull ghcr.io/raylabshq/gitea-mirror:pr-247` Then run with your normal env plus: - `MIRROR_STARRED=true` - `MIRROR_STARRED_LISTS=<your-list-1>,<your-list-2>` You can verify in UI by selecting the same lists in the new **Star Lists (optional)** control and running import/sync. ![Star Lists UI](https://raw.githubusercontent.com/RayLabsHQ/gitea-mirror/codex/starred-lists-ui/docs/images/starred-lists-ui.png)

GiteaMirror commented

2026-04-16 02:42:53 -05:00

@clement-deltel commented on GitHub (Mar 24, 2026):

Hello,

Thank you for the blazinf fast implementation. Nevertheless, I just tested the image (ghcr.io/raylabshq/gitea-mirror:pr-247), but I am getting the error message below:

Error fetching starred repositories: Configured GitHub star lists not found: docs, dottools, homelab

Also, the UI does not reflect what you showed above with the Star Lists drop-down menu on my end:

I have to mention that I just swapped the image and added the environment variable. I am not starting from a fresh install with an empty database, maybe that's part of the observed difference.

Let me know if you need anything else.

@clement-deltel commented on GitHub (Mar 24, 2026): Hello, Thank you for the blazinf fast implementation. Nevertheless, I just tested the image (`ghcr.io/raylabshq/gitea-mirror:pr-247`), but I am getting the error message below: ```text Error fetching starred repositories: Configured GitHub star lists not found: docs, dottools, homelab ``` Also, the UI does not reflect what you showed above with the Star Lists drop-down menu on my end: <img width="771" height="381" alt="Image" src="https://github.com/user-attachments/assets/feaed654-6df8-4e3f-834d-7ccd27f180a7" /> I have to mention that I just swapped the image and added the environment variable. I am not starting from a fresh install with an empty database, maybe that's part of the observed difference. Let me know if you need anything else.

GiteaMirror commented

2026-04-16 02:42:53 -05:00

@arunavo4 commented on GitHub (Mar 24, 2026):

@clement-deltel I just ran it locally and tested with my github keys, everything worked. Can try using the UI and please share you config vars and remove any private keys when you share them.

@arunavo4 commented on GitHub (Mar 24, 2026): @clement-deltel I just ran it locally and tested with my github keys, everything worked. Can try using the UI and please share you config vars and remove any private keys when you share them. <img width="802" height="564" alt="Image" src="https://github.com/user-attachments/assets/b0d41dc0-8cd0-4222-822f-4313dab52884" />

GiteaMirror commented

2026-04-16 02:42:54 -05:00

@clement-deltel commented on GitHub (Mar 25, 2026):

Hello,
I did some further testing, and it is working now. Thank you so much!

@clement-deltel commented on GitHub (Mar 25, 2026): Hello, I did some further testing, and it is working now. Thank you so much!

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: github-starred/gitea-mirror#722