{"id":15065603,"url":"https://github.com/yusuf8ahmed/ship","last_synced_at":"2025-10-08T10:47:56.610Z","repository":{"id":43235434,"uuid":"268148020","full_name":"yusuf8ahmed/Ship","owner":"yusuf8ahmed","description":"Ship is a simple Python command-line application that makes transferring files from one computer to another phone or another computer easy","archived":false,"fork":false,"pushed_at":"2022-11-22T06:29:52.000Z","size":26110,"stargazers_count":48,"open_issues_count":2,"forks_count":4,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-09-24T22:47:04.723Z","etag":null,"topics":["argparse","bash","cli","cmd","command-line","command-line-tool","css","file-format","file-manager","file-sharing","filesystem","html","http-server","python","python3","transferring-files"],"latest_commit_sha":null,"homepage":"https://yusuf8ahmed.github.io/Ship","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/yusuf8ahmed.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}},"created_at":"2020-05-30T19:40:58.000Z","updated_at":"2023-08-20T06:59:47.000Z","dependencies_parsed_at":"2023-01-24T00:17:08.393Z","dependency_job_id":null,"html_url":"https://github.com/yusuf8ahmed/Ship","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/yusuf8ahmed/Ship","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yusuf8ahmed%2FShip","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yusuf8ahmed%2FShip/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yusuf8ahmed%2FShip/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yusuf8ahmed%2FShip/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yusuf8ahmed","download_url":"https://codeload.github.com/yusuf8ahmed/Ship/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yusuf8ahmed%2FShip/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278931652,"owners_count":26070788,"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","status":"online","status_checked_at":"2025-10-08T02:00:06.501Z","response_time":56,"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":["argparse","bash","cli","cmd","command-line","command-line-tool","css","file-format","file-manager","file-sharing","filesystem","html","http-server","python","python3","transferring-files"],"created_at":"2024-09-25T00:42:56.597Z","updated_at":"2025-10-08T10:47:56.575Z","avatar_url":"https://github.com/yusuf8ahmed.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Ship 🚢\n\nShip is a command line application that makes transferring files from a computer to a phone or another computer easy \u003cbr\u003e\nShip is Developed on macOS Catalina and should work on all platforms that python3 supports\n\u003cbr\u003e\n[![Downloads](https://pepy.tech/badge/shipapp)](https://pepy.tech/project/shipapp)\n\u003cbr\u003e\n\u003ca href=\"https://www.producthunt.com/posts/ship-9?utm_source=badge-featured\u0026utm_medium=badge\u0026utm_souce=badge-ship-9\" target=\"_blank\"\u003e\u003cimg src=\"https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=206345\u0026theme=light\" alt=\"Ship - The best way to move files between your devices | Product Hunt Embed\" style=\"width: 250px; height: 54px;\" width=\"250px\" height=\"54px\" /\u003e\u003c/a\u003e\n\u003cbr\u003e\n[![forthebadge](https://forthebadge.com/images/badges/uses-badges.svg)](https://forthebadge.com)\n[![forthebadge](https://forthebadge.com/images/badges/made-with-python.svg)](https://forthebadge.com)\n[![forthebadge](https://forthebadge.com/images/badges/powered-by-electricity.svg)](https://forthebadge.com)\n\n## Table of Contents\n  * [Requirements 📺](#requirements-📺)\n  * [Installation ⬆️](#installation-⬆️)\n  * [uninstallation ⬇️](#uninstallation-⬇️)\n  * [Usage 💯](#usage-💯)\n  * [Releases 🏭](#releases-🏭)\n  * [Common issues when Installing 🪑](#common-issues-when-installing-🪑)\n  * [Platforms Tested on 🧪](#platforms-tested-on-🧪)\n\n# Requirements 📺\n* pip is required to download ship\n* to download pip on windows users use click [Python 3.7.7](https://www.python.org/ftp/python/3.7.7/python-3.7.7-amd64-webinstall.exe)\n* to download pip on darwin macOS(for OS X 10.9 and later) click [Python 3.7.7](https://www.python.org/ftp/python/3.7.7/python-3.7.7-macosx10.9.pkg)\n\n## Installation ⬆️ \n* Obviously should not be install in a virtual environment\n```bash\npip install shipapp\n```\n\n## Uninstallation ⬇️\n```bash\npip uninstall shipapp\n```\n\n# Usage 💯\n\n## How to use (Basic)\n1. Type in the command and filename that you want to share.\n```bash \nship [FILENAME]\n```\n\n2. Copy the url into another device browser (can be phone or computer).\n```bash\nMake sure to click 'ctrl-c' to kill after usage\nMon Jul  6 22:37:27 2020 Sharing Server Starts - http://0a1752d38560.ngrok.io\n```\n\n3. Download by clicking 'Ship It' and close the server by clicking \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003ec\u003c/kbd\u003e\n```bash\n^CMon Jul  6 23:26:38 2020 Sharing Server Stop - http://0a1752d38560.ngrok.io\n```\n\n## Advanced Information ⚙️\n```bash \nusage: ship [-h] [-p [port]] [-q] [-P] [-L] [-l] [-V] [-v] [main]\n\nSend file to phone or other computers. Make sure to kill this process after completetion\nif your phone is having trouble reading qrcode use flag -q: ship -q [FILENAME]\n\npositional arguments:\n  main                  file to be shared\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -p [port], --port [port]\n                        port to be shared on\n  -q, --qrcode          if flagged qrcode will be in new tab\n  -o, --open            if flagged browser will open automatically\n  -P, --private         if flagged host address will be on private ip\n  -L, --localhost       if flagged host address will be localhost\n  -l, --link            if flagged ship will start the Link Sharing Server\n  -V, --verbose         if flagged additional details will be shown via stdout\n  -v, --version         show program's version number and exit\n```\n\n# Releases 🏭\n\n## alpha release v0.0.4.0 (In development/unstable)\nShip will watch a file and will restart server with new file content\u003cbr\u003e\nShip can now be called from within Python as Shipapp.ShipIt\u003cbr\u003e\n\n## alpha release v0.0.3.0\nNow Ship can fallback on an Empty port if port 9999 is being used \u003cbr\u003e\nWhole codebase revamp/rewrite with better errors and comments\u003cbr\u003e\nNow you can run multiple instance on Ship\u003cbr\u003e\nWhole design with use of external css\u003cbr\u003e\nShip can now share links on top of files\u003cbr\u003e\nnew -o, --open cli flag auto open browsers on host computer \u003cbr\u003e\nnew -P, --private cli flag: if flagged host address will be on private ip\u003cbr\u003e\nnew -L, --local cli flag: force port to localhost/127.0.0.1\u003cbr\u003e\nnew -V, --verbose cli flag: additional details will be shown via stdout\u003cbr\u003e\nnew -l, --link cli flag: ship will start the Link Sharing Server\u003cbr\u003e\n\n### **alpha release v0.0.2.1**\n### **alpha release v0.0.2.0**\nfull release on pypi \u003cbr\u003e\nsupport for inline and new tab qrcodes \u003cbr\u003e\nnew -q, --qrcode cli flag: to display flag \u003cbr\u003e\nnew -V, -version cli flag: to show version \u003cbr\u003e\nmore readable errors \u003cbr\u003e\ngit clone installation is not long available \u003cbr\u003e\n\n### **alpha release v0.0.1.6**\nhelp file update \u003cbr\u003e\n\n### **alpha release v0.0.1.5**\nbuild dist errors \u003cbr\u003e\n\n### **alpha release v0.0.1.4**\nfloat right on all templates \u003cbr\u003e\n\n### **alpha release v0.0.1.3**\nbuild dist errors \u003cbr\u003e\n\n### **alpha release v0.0.1.2**\ntemplate decision error fixed \u003cbr\u003e\ntext template fixed \u003cbr\u003e\nerror raising error fixed \u003cbr\u003e\n\n### **alpha release v0.0.1.1**\ninitial release\n\n# Common issues when Installing 🪑\n\n## Ubuntu PATH issue when downloading \nWhen installing ship (shipapp) python might say that script is not placed in\nThe PATH to solve this problem follow the steps\n\n1. enter bashrc config file with vim \n```bash\nvi .bashrc\n```\n2. enter insert mode in vim \u003ckbd\u003eEsc\u003c/kbd\u003e then press \u003ckbd\u003ei\u003c/kbd\u003e for insert\n3. then at the top write with the path the python outputted\n```bash\nexport PATH='(the path that python outputted):$PATH'\n```\n4. then exit vim by pressing \u003ckbd\u003eEsc\u003c/kbd\u003e then typing \u003ckbd\u003e:\u003c/kbd\u003e\u003ckbd\u003ew\u003c/kbd\u003e \u003ckbd\u003eq\u003c/kbd\u003e\n5. then exit the terminal and enter again then ship command should now be available 😀\n\n# Platforms Tested on 🧪\n\n### MacOS Catalina - version 10.15.6 😀😀\n### Windows 10 - version 2004 😀😀\n### Canonical Ubuntu - version 20.04 😀😀\n\n# Issues 🤫\n## Templating\nSince the template are loaded in with python format method anything the uses curly braces will cause an error which include: any Javascript function, if statements, try - except blocks and embedded css.\n\n## Mimetypes \nCan only load in mimetypes defined in the standard package.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyusuf8ahmed%2Fship","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyusuf8ahmed%2Fship","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyusuf8ahmed%2Fship/lists"}