{"id":47684760,"url":"https://github.com/paulxiong/uhella","last_synced_at":"2026-05-31T06:01:30.758Z","repository":{"id":343154334,"uuid":"1163658059","full_name":"paulxiong/uhella","owner":"paulxiong","description":"Uhella —Free up your iCloud Space without paying more.","archived":false,"fork":false,"pushed_at":"2026-05-25T20:56:09.000Z","size":48992,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-25T22:29:26.627Z","etag":null,"topics":["agent","ai","album","automatically","icloud","nas","photos"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/paulxiong.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-22T00:12:18.000Z","updated_at":"2026-05-19T08:02:32.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/paulxiong/uhella","commit_stats":null,"previous_names":["paulxiong/uhella"],"tags_count":92,"template":false,"template_full_name":null,"purl":"pkg:github/paulxiong/uhella","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulxiong%2Fuhella","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulxiong%2Fuhella/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulxiong%2Fuhella/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulxiong%2Fuhella/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/paulxiong","download_url":"https://codeload.github.com/paulxiong/uhella/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulxiong%2Fuhella/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33720897,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-31T02:00:06.040Z","response_time":95,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","ai","album","automatically","icloud","nas","photos"],"created_at":"2026-04-02T14:39:36.064Z","updated_at":"2026-05-31T06:01:30.741Z","avatar_url":"https://github.com/paulxiong.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\u003cimg width=\"1024\" height=\"1536\" alt=\"1page_backend_1\" src=\"https://github.com/user-attachments/assets/b34cd72d-176b-44dd-bb46-093375b3bd2e\" /\u003e\n\n\u003cimg width=\"1024\" height=\"1536\" alt=\"1pq_backend_zh_1\" src=\"https://github.com/user-attachments/assets/79d40b15-6e03-4d68-878f-3e60e21f7df6\" /\u003e\n\n# Uhella Backend User Guide\n\nUhella Backend is the small Mac app that runs the Uhella server on your Mac.\n\nIt is **free**.\n\n---\n\n## Installation\n\nFor the **first install**, download the **.dmg** and install Uhella Backend like a normal Mac app.\n\nAfter you open it, Uhella shows a **simple step-by-step setup window**. It guides you through everything with a normal Mac UI.\n\nNo terminal. No manual server setup.\n\nIf macOS asks for **Photos access**, allow it.\n\nThe first setup can take some time because it may need to download several GB of files.\n\n---\n\n## Automatic updates\n\nAfter the first install, Uhella Backend checks for updates automatically every **6 hours**.\n\nBy default, it downloads and installs upgrades for you automatically.\n\n---\n\n## Telegram setup\n\nIf you want to use Uhella from your phone, set up Telegram inside the app.\n\nUhella guides you step by step:\n\n1. Create a bot with **@BotFather**\n2. Paste the bot token into Uhella\n3. Find your Telegram ID with **@userinfobot**\n4. Confirm that Telegram messages reach you\n\nThere is also an optional step for **large video downloads**.\n\n---\n\n## Daily use\n\nUhella Backend lives in the **macOS menu bar**.\n\n![Uhella Backend menu](menu.png)\n\nFrom there you can use:\n\n- **Open Uhella**\n- **Start at Login**\n- **Keep Awake**\n- **Photo Library**\n- **Telegram Bot**\n- **Configure Telegram**\n- **Check for Updates**\n- **Quit Uhella Backend**\n\nIf you have more than one Photos library, you can switch libraries there too.\n\nWhen Uhella has photos or videos ready to move, it can send a Telegram notification with a **Move** button.\n\n---\n\n## Best setup\n\nA Mac that can stay on works well.\n\nA **Mac mini** is an even better choice if you travel a lot or want Uhella available anytime.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaulxiong%2Fuhella","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpaulxiong%2Fuhella","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaulxiong%2Fuhella/lists"}