{"id":47516110,"url":"https://github.com/mshirazkamran/filebin-api","last_synced_at":"2026-04-01T07:00:41.588Z","repository":{"id":292632318,"uuid":"980699185","full_name":"mshirazkamran/filebin-api","owner":"mshirazkamran","description":"A wrapper over the filebin.net API. Let's you upload, download files without hosting them on your own. A temporary file storage ","archived":false,"fork":false,"pushed_at":"2025-09-18T11:35:51.000Z","size":16179,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-09-25T14:25:24.674Z","etag":null,"topics":["api","application-programming-interface","cli-app","file-upload","filebin","python","python-script","python3","requests-library-python","requests-python","venv-python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mshirazkamran.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-05-09T15:02:51.000Z","updated_at":"2025-09-18T11:35:54.000Z","dependencies_parsed_at":"2025-07-13T12:10:33.286Z","dependency_job_id":"12632029-60d2-4104-9bdb-bd1a1e3e7842","html_url":"https://github.com/mshirazkamran/filebin-api","commit_stats":null,"previous_names":["mshirazkamran/filebin-api"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mshirazkamran/filebin-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mshirazkamran%2Ffilebin-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mshirazkamran%2Ffilebin-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mshirazkamran%2Ffilebin-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mshirazkamran%2Ffilebin-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mshirazkamran","download_url":"https://codeload.github.com/mshirazkamran/filebin-api/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mshirazkamran%2Ffilebin-api/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31269176,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T06:57:45.811Z","status":"ssl_error","status_checked_at":"2026-04-01T06:57:42.389Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["api","application-programming-interface","cli-app","file-upload","filebin","python","python-script","python3","requests-library-python","requests-python","venv-python"],"created_at":"2026-03-27T13:00:30.245Z","updated_at":"2026-04-01T07:00:41.583Z","avatar_url":"https://github.com/mshirazkamran.png","language":"Python","readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/mshirazkamran/filebin-api/master/images/fbin-logo.png\" width=\"350\" alt=\"logo\"/\u003e\n\u003c/p\u003e\n\n\u003ch1  align=\"center\"\u003e\n  Filebin cli\n\u003c/h1\u003e\n\n### A cli tool to **share files temporarily** without any hassle, directly from your terminal. No login. No setup. Just share the **short code** to download on the other machine. Ensures some privacy (refer to [Useful tips](#useful-to-know) )\n\n it interacts with the file-sharing service [filebin.net](https://filebin.net).\n\n---\n\n## 📑 Table of Contents\n\n- [Useful tips](#useful-to-know)\n- [Features](#features)\n- [Installation](#installation)\n- [Quick Start \u0026 Examples](#quick-start--examples)\n  - [Upload Files](#-upload-files)\n  - [Get Bin Details](#-get-bin-details)\n  - [Download Files](#-download-files)\n  - [Download Bin as  archive](#️-download-archive)\n  - [Manage Bins](#️-manage-bins)\n- [🧾 Command Reference](#-command-reference)\n  - [`upload`](#upload)\n  - [`details`](#details)\n  - [`download`](#download)\n  - [`lock`](#lock)\n  - [`delete`](#delete)\n  - [`archive`](#archive)\n- [🔧 Requirements](#-requirements)\n- [🧑‍💻 Author](#-author)\n- [LICENSE](#license)\n\n---\n## Useful To know:\n- Bins are like folders where you can upload files. They can be downloaded, updated with files, locked and deleted\n- Short code is a mapping for bins that allows to remember your bin. eg: sweet-mango16 for binid A904hbhu897SAD4Q\n- Bins are auto deleted after 7 days, that is if not deleted by the user himself\n- Ensures some level of privacy because the bins are made with 16 digit unique alhpanumeric id and only the people having the link(or short code) can access the content\n---\n\n## Features\n\n- **Upload :** one or multiple files to a new or existing bin.\n- **Shortcode Access :**: Use **human-readable shortcodes** like `good-apple81` or `sweet-mango37` instead of remembering long bin IDs to interact with bins and files.\n- **Download :** As simple files or download complete bin as archive (tar and zip supported)\n- **List :** the contents of any bin with basic or detailed metadata.\n- **Lock :** a bin to make it read-only.\n- **Delete :** an entire bin permanently.\n\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/mshirazkamran/filebin-api/master/images/usage.png\" width=\"750\"/\u003e\n\u003c/p\u003e\n\n## NOTE: Works on python 3.7.9+ due to openssl 1.1.1 dependency\n\n## Installation\n\nInstall the tool from PyPI using pip:\n```\npip install filebin-cli\n```\n\n## Quick Start \u0026 Examples\n\n---\n\n### 📤 Upload Files\n\n* **Upload a single file to a new bin:**\n\n    ```bash\n    fbin upload document.pdf\n    ```\n\n* **Upload multiple files to a new bin:**\n\n    ```bash\n    fbin upload image.jpg report.docx archive.zip\n    ```\n\n* **Upload a file to a specific, existing bin using a bin ID:**\n\n    ```bash\n    fbin upload --binid 3s8h9gqz2d new-file.txt\n    ```\n\n* **Upload a file using a shortcode:**\n\n    ```bash\n    fbin upload -b good-apple81 new-file.txt\n    ```\n\n---\n\n### 📋 Get Bin Details\n\n* **List the files in a bin using a bin ID:**\n\n    ```bash\n    fbin details 3s8h9gqz2d\n    ```\n\n* **List the files using a shortcode:**\n\n    ```bash\n    fbin details good-apple81\n    ```\n\n* **Get detailed metadata:**\n\n    ```bash\n    fbin details -d sweet-mango37\n    ```\n\n---\n\n### 📥 Download Files\n\n* **Download a single file from a bin using bin ID:**\n\n    ```bash\n    fbin download --binid 3s8h9gqz2d document.pdf\n    ```\n\n* **Download a single file using shortcode:**\n\n    ```bash\n    fbin download --binid sweet-mango37 document.pdf\n    ```\n\n* **Download multiple files:**\n\n    ```bash\n    fbin download good-apple81 image.jpg report.docx\n    ```\n\n* **Download files to a specific directory:**\n\n    ```bash\n    fbin download good-apple81 main.py -p /path/to/my/downloads\n    ```\n\n---\n\n## 🗜️ Download Archive\n\n* **Download all files from a bin as a ZIP archive (default):**\n\n    ```bash\n    fbin archive A5yv3s8h9gqz2d\n    ```\n\n* **Download all files from a bin as a TAR archive (using shortcode):**\n\n    ```bash\n    fbin archive --type tar good-orange92\n    ```\n\n* **Specify a custom output directory for the archive:**\n\n    ```bash\n    fbin archive --type zip --path ./downloads white-cat12\n    ```\n\n---\n\n### 🛠️ Manage Bins\n\n* **Lock a bin (permanent action):**\n\n    ```bash\n    fbin lock good-apple81\n    ```\n\n* **Delete a bin and all contents (permanent action):**\n\n    ```bash\n    fbin delete sweet-mango37\n    ```\n\n---\n\n\n## 🧾 Command Reference\n\n### `upload`\n\nUploads one or more files. If no `--binid` is provided, a new bin is created automatically.\n\n**Usage:**\n\n```bash\nfbin upload [OPTIONS] [PATHS]...\n````\n\n**Arguments:**\n\n  * `PATHS...`: One or more paths to the files you want to upload.\n\n**Options:**\n\n  * `--binid TEXT`: Specify an existing bin ID or shortcode to upload to.\n\n### `details`\n\nFetches and displays the metadata for all files in a specified bin.\n\n**Usage:**\n\n```bash\nfbin details [OPTIONS] BINID_OR_SHORTCODE\n```\n\n**Arguments:**\n\n  * `BINID_OR_SHORTCODE`: The ID or shortcode of the bin you want to inspect.\n\n**Options:**\n\n  * `-d, --details`: Display detailed metadata, including timestamps and MD5 hash.\n\n### `download`\n\nDownloads one or more files from a bin.\n\n**Usage:**\n\n```bash\nfbin download [OPTIONS] BINID_OR_SHORTCODE [FILENAMES]...\n```\n\n**Arguments:**\n\n  * `BINID_OR_SHORTCODE`: The ID or shortcode of the bin to download from.\n  * `FILENAMES...`: The exact name(s) of the file(s) to download.\n\n**Options:**\n\n  * `-p, --path TEXT`: The local directory path where files should be saved. Defaults to the current directory.\n\n### `lock`\n\nPermanently locks a bin, making it read-only. No new files can be uploaded.\n\n**Usage:**\n\n```bash\nfbin lock BINID_OR_SHORTCODE\n```\n\n**Arguments:**\n\n  * `BINID_OR_SHORTCODE`: The ID or shortcode of the bin to lock.\n\n-----\n### `archive`\n\nDownloads all files in a bin as a `.zip` or `.tar` archive.\n\n**Usage:**\n\n```bash\nfbin archive [OPTIONS] BINID\n```\n\n**Arguments:**\n\n  * `BINID`: The ID of the bin to archive.\n\n**Options:**\n\n  * `--path, -p TEXT`: The destination directory to save the archive (default: `root`).\n  * `--type, -t [tar|zip]`: The archive format to use (required, default: `zip`).\n\n---\n\n### `delete`\n\nPermanently deletes a bin and all of its contents.\n\n**Usage:**\n\n```bash\nfbin delete BINID_OR_SHORTCODE\n```\n\n**Arguments:**\n\n  * `BINID_OR_SHORTCODE`: The ID or shortcode of the bin to delete.\n\n-----\n\n## 🔧 Requirements\n\n  * `click`\n  * `requests`\n    \nrefer to requirements.txt for more info\n\n-----\n\n## 🧑‍💻 Author\n\nMade and managed by [@mshirazkamran](https://github.com/mshirazkamran)\n\n-----\n\n## LICENSE\n\nThis tool is Licensed under the MIT license.\n","funding_links":[],"categories":["\u003ca name=\"transfer\"\u003e\u003c/a\u003eData transfer"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmshirazkamran%2Ffilebin-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmshirazkamran%2Ffilebin-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmshirazkamran%2Ffilebin-api/lists"}