{"id":23693369,"url":"https://github.com/alyetama/gofile","last_synced_at":"2025-09-02T20:34:02.369Z","repository":{"id":44846534,"uuid":"313200515","full_name":"Alyetama/Gofile","owner":"Alyetama","description":"Upload files to gofile.io","archived":false,"fork":false,"pushed_at":"2024-08-13T15:52:28.000Z","size":33,"stargazers_count":21,"open_issues_count":2,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-11-30T21:40:48.305Z","etag":null,"topics":["cli","gofile","python","upload"],"latest_commit_sha":null,"homepage":"https://alyetama.github.io/Gofile","language":"Python","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/Alyetama.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}},"created_at":"2020-11-16T05:30:39.000Z","updated_at":"2024-09-08T18:34:24.000Z","dependencies_parsed_at":"2024-06-20T00:31:21.041Z","dependency_job_id":null,"html_url":"https://github.com/Alyetama/Gofile","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alyetama%2FGofile","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alyetama%2FGofile/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alyetama%2FGofile/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alyetama%2FGofile/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Alyetama","download_url":"https://codeload.github.com/Alyetama/Gofile/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":231810738,"owners_count":18430003,"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":["cli","gofile","python","upload"],"created_at":"2024-12-30T03:51:48.589Z","updated_at":"2024-12-30T03:51:51.736Z","avatar_url":"https://github.com/Alyetama.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# gofile\n\n🚀 Python wrapper for gofile.io Upload API[^1].\n\n[![Build](https://github.com/Alyetama/gofile/actions/workflows/poetry-build.yml/badge.svg)](https://github.com/Alyetama/gofile/actions/workflows/poetry-build.yml) [![PyPI version](https://badge.fury.io/py/gofilepy.svg)](https://pypi.org/project/gofilepy) [![Supported Python versions](https://img.shields.io/badge/Python-%3E=3.7-blue.svg)](https://www.python.org/downloads/) [![PEP8](https://img.shields.io/badge/Code%20style-PEP%208-orange.svg)](https://www.python.org/dev/peps/pep-0008/) \n\n\n## Requirements\n- 🐍 [python\u003e=3.7](https://www.python.org/downloads/)\n\n\n## ⬇️ Installation\n\n```sh\npip install gofilepy\n```\n\n## ⬆️  Upgrade Existing Installation\n\n```sh\npip install -U gofilepy\n```\n\n\n## ⌨️ Usage\n\n```\nusage: gofilepy [-h] [-s] [-o] [-e] [-vv] [-v] path [path ...]\n\nExample: gofile \u003cfile/folder_path\u003e\n\npositional arguments:\n  path                  Path to the file(s) and/or folder(s)\n\noptions:\n  -h, --help            show this help message and exit\n  -s, --to-single-folder\n                        Upload multiple files to the same folder. All files\n                        will share the same URL. This option requires a valid\n                        token exported as: `GOFILE_TOKEN`\n  -o, --open-urls       Open the URL(s) in the browser when the upload is\n                        complete (macOS-only)\n  -e, --export          Export upload response(s) to a JSON file\n  -vv, --verbose        Show more information\n```\n\n## 📕 Examples\n\n### Example 1: Uploading one file\n\n```sh\n➜ gofile foo.txt\n╭───────────────────────────────────────────╮\n│ File: foo.txt                             │\n│ Download page: https://gofile.io/d/PkdZP5 │\n╰───────────────────────────────────────────╯\nUploading progress: ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:00:00\n```\n\n### Example 2: Uploading multiple files/directories\n\n```bash\n➜ gofile foo.txt bar.txt foobar.txt foo/\n╭───────────────────────────────────────────╮\n│ File: foo.txt                             │\n│ Download page: https://gofile.io/d/rLwQVZ │\n╰───────────────────────────────────────────╯\n╭───────────────────────────────────────────╮\n│ File: bar.txt                             │\n│ Download page: https://gofile.io/d/DdS7mZ │\n╰───────────────────────────────────────────╯\n╭───────────────────────────────────────────╮\n│ File: foobar.txt                          │\n│ Download page: https://gofile.io/d/C1VicP │\n╰───────────────────────────────────────────╯\n╭───────────────────────────────────────────╮\n│ File: foo/foo_1.txt                       │\n│ Download page: https://gofile.io/d/CkYw18 │\n╰───────────────────────────────────────────╯\nUploading progress: ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:00:00\n```\n\n### Example 3: Uploading multiple files to the same URL\n\nThis option requires a Gofile token (see: [## Misc.](#misc)).\n\n```bash\n➜ gofile -s foo.txt bar.txt\n╭───────────────────────────────────────────╮\n│ Files:                                    │\n│ foo.txt                                   │\n│ bar.txt                                   │\n│ Download page: https://gofile.io/d/bFwawd │\n╰───────────────────────────────────────────╯\nUploading progress: ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:00:00\n```\n\n### Example 4: Verbose output\n\n```sh\n➜ gofile -vv foo.txt\n╭──────────────────────────────────────────────────────────────────────────────╮\n│ {                                                                            │\n│   \"foo.txt\": {                                                               │\n│     \"timestamp\": \"30-05-2022 18:42:15\",                                      │\n│     \"response\": {                                                            │\n│       \"status\": \"ok\",                                                        │\n│       \"data\": {                                                              │\n│         \"guestToken\": \"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\",                    │\n│         \"downloadPage\": \"https://gofile.io/d/sU4hV1\",                        │\n│         \"code\": \"sU4hV1\",                                                    │\n│         \"parentFolder\": \"7ad2d249-96a1-4675-b185-05665fbc9a46\",              │\n│         \"fileId\": \"0e93e093-d122-4e42-a1be-2e7d34d78ffb\",                    │\n│         \"fileName\": \"foo.txt\",                                               │\n│         \"md5\": \"d41d8cd98f00b204e9800998ecf8427e\"                            │\n│       }                                                                      │\n│     }                                                                        │\n│   }                                                                          │\n│ }                                                                            │\n╰──────────────────────────────────────────────────────────────────────────────╯\nUploading progress: ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:00:00\n```\n\n### Example 5: Exporting the API response to a JSON file\n\n```sh\n➜ gofile -e foo.txt\n╭───────────────────────────────────────────╮\n│ File: foo.txt                             │\n│ Download page: https://gofile.io/d/8t79Lz │\n╰───────────────────────────────────────────╯\nUploading progress: ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:00:00\nExported data to: gofile_export_1653950555.json\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eContent of \u003ccode\u003egofile_export_1653950555.json\u003c/code\u003e\u003c/summary\u003e\n  \n```json\n[\n    {\n        \"foo.txt\": {\n            \"timestamp\": \"30-05-2022 18:42:35\",\n            \"response\": {\n                \"status\": \"ok\",\n                \"data\": {\n                    \"guestToken\": \"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\",\n                    \"downloadPage\": \"https://gofile.io/d/8t79Lz\",\n                    \"code\": \"8t79Lz\",\n                    \"parentFolder\": \"05xd4cb-8965-417f-ae34-a116et99b798\",\n                    \"fileId\": \"d1fc3a97-8xe3-486a-bc0d-edb1rb103040\",\n                    \"fileName\": \"foo.txt\",\n                    \"md5\": \"d41d8cd99f00b204e9810998ecf8427e\"\n                }\n            }\n        }\n    }\n]\n```\n\u003c/details\u003e\n\n## Misc.\n\n### 🔑 Optional: Saving uploads to your Gofile account\n\nIf you want the files to be uploaded to a specific account, you can export your gofile token, which can be retrieved from the [profile page](https://gofile.io/myProfile), as an environment variable `GOFILE_TOKEN`.\n\n```sh\nexport GOFILE_TOKEN='xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'\n```\n\n\n[^1]: **Disclaimer: This tool is not associated with Gofile, WOJTEK SAS ©, or the Gofile Team.**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falyetama%2Fgofile","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falyetama%2Fgofile","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falyetama%2Fgofile/lists"}