{"id":13446191,"url":"https://github.com/khrj/TeleDrive","last_synced_at":"2025-03-21T06:31:04.842Z","repository":{"id":37186660,"uuid":"283761791","full_name":"khrj/teledrive","owner":"khrj","description":"TeleDrive lets you automatically backup all your files to telegram saved messages - this means FREE, UNLIMITED storage","archived":false,"fork":false,"pushed_at":"2023-01-07T04:52:45.000Z","size":36223,"stargazers_count":200,"open_issues_count":38,"forks_count":26,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-03-04T22:41:54.524Z","etag":null,"topics":["backup","electron","restore","telegram"],"latest_commit_sha":null,"homepage":"https://teledrive.khushrajrathod.com/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/khrj.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-07-30T12:02:23.000Z","updated_at":"2025-03-04T05:19:04.000Z","dependencies_parsed_at":"2023-02-06T12:31:00.551Z","dependency_job_id":null,"html_url":"https://github.com/khrj/teledrive","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khrj%2Fteledrive","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khrj%2Fteledrive/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khrj%2Fteledrive/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khrj%2Fteledrive/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/khrj","download_url":"https://codeload.github.com/khrj/teledrive/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244750524,"owners_count":20504072,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["backup","electron","restore","telegram"],"created_at":"2024-07-31T05:00:47.904Z","updated_at":"2025-03-21T06:31:04.830Z","avatar_url":"https://github.com/khrj.png","language":"JavaScript","funding_links":[],"categories":["Desktop Apps"],"sub_categories":[],"readme":"\u003cimg src=\"icon/vector/banner.svg\" alt=\"TeleDrive logo\" width=\"100%\"\u003e\n\n\u003e TeleDrive lets you automatically backup ANY files to Telegram Saved Messages - this means **UNLIMITED** storage, as long as each file is under 2GB\n\n\u003cdiv align=\"center\"\u003e\n\u003ca href=\"https://teledrive.khushrajrathod.me/api/?type=AppImage\"\u003e\n  \u003cimg alt=\"Download as an AppImage\" src=\"icon/vector/download-appimage.svg\" /\u003e\n\u003c/a\u003e\n\nDownload links: \u003cbr\u003e\n\u003ca href=\"https://teledrive.khushrajrathod.me/api/?type=exe\"\u003eWindows (NSIS)\u003c/a\u003e --- \u003ca href=\"https://teledrive.khushrajrathod.me/api/?type=dmg\"\u003emacOS (DMG)\u003c/a\u003e\n\u003c/div\u003e\n\n---\n\nAlternatively, for macOS, install using [homebrew](https://brew.sh/)\n```bash\nbrew cask install --no-quarantine khushrajrathod/teledrive/teledrive\n```\n\u003e See [code signing](https://github.com/khrj/TeleDrive/issues/10) for more info on why --no-quarantine is used\n\n# Screenshots\n\n\u003cimg src=\"images/auth/Auth-PhoneNumber.png\" alt=\"Authentication - Phone Number\" width=\"350px\"\u003e \u003cimg src=\"images/auth/Auth-selectdir.png\" alt=\"Authentication - Select Dir\" width=\"350px\"\u003e \u003cimg src=\"images/auth/Auth-success.png\" alt=\"Authentication - Success\" width=\"350px\"\u003e \u003cimg src=\"images/conflict/conflict.png\" alt=\"Conflict\" width=\"350px\"\u003e\n\n# How does it work?\nTeleDrive watches a folder for changes and automatically uploads any files contained within that folder to Telegram's saved messages. TeleDrive tags sub folders with their names, so when you restore your files using TeleDrive, you automatically get your folder structure back. For e.x if a TeleDrive's synced folder contains two sub folders, each containing one file:\n\n```\nTeleDriveSync ---- ----- Folder1 ----- MyFile1.txt\n                 |\n                 |\n                 |\n                 | ----- Folder2 ----- MyFile2.txt\n\n```\n\nThen TeleDrive will upload your files with the following tags:\n\n- #TeleDrive /Folder1/MyFile1.txt\n- #TeleDrive /Folder2/MyFile2.txt\n\nThis preserves your folder structure, even in a chat like Telegram's saved messages - This means that when you restore your files, you get the exact same folder structure back.\n\n```\nTeleDriveSync ---- ----- Folder1 ----- MyFile1.txt\n                 |\n                 |\n                 |\n                 | ----- Folder2 ----- MyFile2.txt\n```\n\n# Features\n\n- Watch a folder for changes and automatically reupload when files are changed\n- Preserve folder structure when restoring using TeleDrive\n- Uses a master file for quickly finding messages and file versioning\n- SHA256 based file versioning\n- Queue viewer for uploads\n- Built in conflict resolver\n  - When there's a newer file on Saved Messages but you're trying to backup\n\n# Running from source\n1. Clone repository:\n```bash\ngit clone https://github.com/khrj/TeleDrive\ncd TeleDrive\n```\n\n2. Get dependencies:\n```bash\nyarn\n```\n\n3. Run:\n```bash\nyarn start\n```\n\n# Built with:\n\n- [Electron](https://www.electronjs.org/)\n- [Electron Builder](https://www.electron.build/)\n- [Airgram](https://airgram.io/)\n- [Chokidar](https://github.com/paulmillr/chokidar)\n- [Electron Store](https://github.com/sindresorhus/electron-store#readme)\n- [ncp](https://github.com/AvianFlu/ncp)\n- [Electron Log](https://github.com/megahertz/electron-log)\n\n# License:\n- TeleDrive is licensed under the GPLv3 license\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkhrj%2FTeleDrive","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkhrj%2FTeleDrive","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkhrj%2FTeleDrive/lists"}