n0mad1k
d9e01961ff
- Add precise type hints: Optional[Tuple[str, str]] for _fetch_creds(), List[Tuple[str, str, str]] for notify() - Wrap requests.Session in context manager for proper cleanup - Remove unreachable return False after retry loop in _send_matrix()
coe-mirror
Mirror Nightmare_Eclipse repos from Church of Malware to pCloud.
What it does
Monitors Nightmare_Eclipse on git.churchofmalware.org for new or updated repos. Downloads per-commit zip snapshots to ~/pCloudDrive/Hacking/Nightmare_Eclipse/. Falls back to local staging when pCloud is down. Runs at 00:00 and 12:00 daily with boot catch-up.
Filename convention
{repo}_{short_sha}.zip where short_sha is the first 8 chars of the HEAD commit SHA on the default branch. New commits produce new files; old snapshots stay as history.
Install
cd ~/tools/coe-mirror
bash install.sh
Manual run
systemctl --user start coe-mirror.service
# or directly:
python3 ~/tools/coe-mirror/coe_mirror.py
Logs
- File:
~/.local/share/coe-mirror/coe-mirror.log(rotated at 5 MB, 3 backups) - Journal:
journalctl --user -u coe-mirror.service -n 100
Storage estimate
8 repos × 2 runs/day × ~1 commit/repo/day ≈ 16 zips/day ≈ ~5 MB/month at current zip sizes (~265 KB each). Old snapshots accumulate — no automatic pruning. Manually prune ~/pCloudDrive/Hacking/Nightmare_Eclipse/ if needed.
Behavior when pCloud is down
Downloads land in ~/.local/share/coe-mirror/pending/. Next run (or any subsequent invocation) flushes them to pCloud once the mount is healthy. No auto-start of the pCloud daemon — by design, because the daemon is a GUI AppImage with no systemd user unit. If pCloud is offline, ensure the user session is active and pCloud is running before the next scheduled run, or trigger manually.
Catch-up after machine was off
The timer is Persistent=true and OnBootSec=2min. Missed windows run automatically on next boot. The tool also diffs against the pCloud directory, so even if a run is skipped entirely, the next run catches up everything that's missing.
Matrix notification
After every run that lands at least one new zip, coe-mirror posts a summary
to the General room (!MBpPtYlQYMcngtpvJt:m.mealeyfamily.com) on
m.mealeyfamily.com.
- Authentication uses
MATRIX_USER+MATRIX_PASSWORDfrom Infisical foldermatrix. Tokens are cached at~/.local/share/coe-mirror/matrix-token.json(mode 0600) and auto-refreshed on expiry or 401. - Failures are non-fatal: a Matrix outage logs a warning and the rest of the run proceeds normally.
- Override the target room for testing:
COE_MIRROR_MATRIX_ROOM=! ...:host. - Override the homeserver:
COE_MIRROR_MATRIX_HOMESERVER=https://....
Testing
cd ~/tools/coe-mirror
python3 -m pytest tests/ -v
Uninstall
systemctl --user disable --now coe-mirror.timer
rm ~/.config/systemd/user/coe-mirror.{service,timer}
systemctl --user daemon-reload