{"id":28758388,"url":"https://github.com/fujiwarachoki/telesync","last_synced_at":"2025-07-17T23:09:13.171Z","repository":{"id":221872427,"uuid":"753095528","full_name":"FujiwaraChoki/TeleSync","owner":"FujiwaraChoki","description":"Store your files on Telegram (Unlimited Storage).","archived":false,"fork":false,"pushed_at":"2024-04-28T21:26:23.000Z","size":50,"stargazers_count":133,"open_issues_count":1,"forks_count":20,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-06-17T04:08:22.559Z","etag":null,"topics":["backup","cli","files","google-drive","onedrive","sync","telegram"],"latest_commit_sha":null,"homepage":"","language":"Python","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/FujiwaraChoki.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-02-05T13:13:15.000Z","updated_at":"2025-06-13T18:35:43.000Z","dependencies_parsed_at":"2024-02-10T18:47:49.540Z","dependency_job_id":"cc256405-260a-4e5c-8ce6-ce4d6e7d42e2","html_url":"https://github.com/FujiwaraChoki/TeleSync","commit_stats":null,"previous_names":["fujiwarachoki/telesync"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/FujiwaraChoki/TeleSync","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FujiwaraChoki%2FTeleSync","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FujiwaraChoki%2FTeleSync/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FujiwaraChoki%2FTeleSync/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FujiwaraChoki%2FTeleSync/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FujiwaraChoki","download_url":"https://codeload.github.com/FujiwaraChoki/TeleSync/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FujiwaraChoki%2FTeleSync/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265677580,"owners_count":23809998,"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","cli","files","google-drive","onedrive","sync","telegram"],"created_at":"2025-06-17T04:08:21.045Z","updated_at":"2025-07-17T23:09:13.133Z","avatar_url":"https://github.com/FujiwaraChoki.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TeleSync\n\nAn application to store your local files on Telegram.\n\n\u003e 📸 Watch the video on [YouTube](https://youtu.be/vCAcc_q-NNw)\n\n## Features\n\n- Infinite storage (No limit)\n- Easy to use\n- Fast and secure\n- Free \u0026 Open Source\n\n## Prerequisites\n\nYou need a Telegram API ID and API Hash.\nYou can create a new App [here](https://my.telegram.org/apps).\n\n## Installation\n\n```bash\ngit clone https://github.com/FujiwaraChoki/TeleSync.git\ncd TeleSync\n```\n\n\u003e ⚠️: In order to install the dependencies flawlessly, please follow the instructions step-by-step.\n\n## Linux\n\n```bash \npython -m venv venv\nsource venv/bin/activate\n```\n\n## Windows\n\n```bash\npython -m venv venv\n.\\venv\\Scripts\\activate\n```\n\nThen, continue with the installation:\n\n```bash \npip install -r requirements.txt\n# Copy the example.config.json to config.json\ncp example.config.json config.json # Edit the config.json file with your own settings\n```\n\nNext, give the `run.sh` Shell-Script executable permissions:\n\n```bash\nchmod +x run.sh\n```\n\n## Configuration\n\n| Option         | Description                                                                |\n| -------------- | -------------------------------------------------------------------------- |\n| `api_id`       | Your Telegram API ID.                                                      |\n| `api_hash`     | Your Telegram API Hash.                                                    |\n| `phone_number` | Your phone number, which you use for Telegram.                             |\n| `db_file`      | The name of the database file. (Default: `files.db`)                       |\n| `verbose`      | If `true`, the application will print more information. (Default: `false`) |\n\n\n### Commands\n\n| Command                 | Description                            |\n| ----------------------- | -------------------------------------- |\n| `upload [FILE_QUERY]`   | Upload a file to Telegram              |\n| `download [FILE_QUERY]` | Download a file from Telegram          |\n| `remove [FILE_QUERY]`   | Delete a file from Telegram            |\n| `list`                  | List all files in the Telegram Channel |\n\n`FILE_QUERY` can be the file name, file path, the ID of the file, or a part of the file name.\n\n## Adding Script to PATH\n\n### Linux\n\nTo add the script to the PATH in Linux, you can modify the `~/.bashrc` file:\n\n```bash\nexport PATH=\"$PATH:/path/to/TeleSync\"\n```\n### Windows\n\nTo add the script to the PATH in Windows, you can follow these steps:\n\n1. Search for \"Environment Variables\" in the Start menu.\n2. Click on \"Edit the system environment variables\".\n3. In the System Properties window, click on the \"Environment Variables...\" button.\n4. In the Environment Variables window, under System variables, find the Path variable and select it.\n5. Click on the \"Edit...\" button.\n6. Click on the \"New\" button and add the path to the TeleSync directory.\n7. Click \"OK\" on all windows to apply the changes.\n\n\n## Running\n\n### Linux\n\nTo run TeleSync on Linux, navigate to the TeleSync directory in your terminal and execute the following command:\n\n```bash\n./run.sh [COMMAND] [ARGUMENTS]\n```\n\n### Windows\n\nTo run TeleSync on Windows, open Command Prompt, navigate to the TeleSync directory, and execute the following command:\n\n```bash\n.\\run.bat [COMMAND] [ARGUMENTS]\n```\n\n\u003e ⚡: If you added `TeleSync` to your `PATH`, you may run the script from anywhere.\n\n## License\n\nThis project is licensed under the GNU General Public License v3.0 - see the [LICENSE](LICENSE) file for details.\n\n## Issues\n\nIf you find a **bug**, please to open an [issue](https://github.com/FujiwaraChoki/TeleSync/issues). Issues that are not related to bugs will be closed.\n\n## Contributing\n\nOnly **Pull Request**s with **fixes** or/and **improvements** will be accepted.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffujiwarachoki%2Ftelesync","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffujiwarachoki%2Ftelesync","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffujiwarachoki%2Ftelesync/lists"}