{"id":25284840,"url":"https://github.com/stiartsly/hyport-cli","last_synced_at":"2025-04-06T15:14:11.639Z","repository":{"id":75483511,"uuid":"202322690","full_name":"stiartsly/hyport-cli","owner":"stiartsly","description":"Virtual file system to miscellaneous remote cloud storage service.","archived":false,"fork":false,"pushed_at":"2019-08-20T09:46:33.000Z","size":4576,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-12T20:52:37.184Z","etag":null,"topics":["fuse","ipfs","onedrive"],"latest_commit_sha":null,"homepage":"","language":null,"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/stiartsly.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}},"created_at":"2019-08-14T09:51:18.000Z","updated_at":"2021-01-14T03:10:30.000Z","dependencies_parsed_at":"2023-06-06T15:30:45.934Z","dependency_job_id":null,"html_url":"https://github.com/stiartsly/hyport-cli","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stiartsly%2Fhyport-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stiartsly%2Fhyport-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stiartsly%2Fhyport-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stiartsly%2Fhyport-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stiartsly","download_url":"https://codeload.github.com/stiartsly/hyport-cli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247500471,"owners_count":20948880,"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":["fuse","ipfs","onedrive"],"created_at":"2025-02-12T20:52:39.785Z","updated_at":"2025-04-06T15:14:11.622Z","avatar_url":"https://github.com/stiartsly.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"Hyport Command Line Tool\n========================\n\n## 1. Introduction\n\nHyport is a fuse application to allow cloud storage drives to be mounted as your local file system. And you can access/store files on your remote drives as the conduct on your local device.  Currently, the following list of cloud services are supported right now:\n\n- OneDrive\n- IPFS\n\n## 2. Prerequisites\n\nCurrently, the **hyport** command line tool is only supported for **Linux system** (**Ubuntu-16.04** is recommended) and **x86/64** architectures.\n\nAnd the dependency **libfuse-dev** should be installed before using **hyport**. Run the following command to install it:\n\n```shell\n$sudo apt-get install libfuse-dev=2.9.4-1ubuntu3.1\n```\n\nor with simple way like:\n\n```shell\n$sudo apt-get install libfuse-dev\n```\n\n## 3. Deployment\n\nUse the command to clone the repo on your local **Linux**-based machine:\n\n```shell\n$ git clone https://github.com/stiartsly/hyport-cli.git\n$ cd hyport-cli/bin\n```\n\n## 4. Usage\n\nRun the following command to get usage to **hyport** cli:\n\n\n```shell  \n$ ./hyport -h\nusage: hyport [options] \u003cmountpoint\u003e\nFile-system specific options:\n    --config=\u003cs\u003e    Path of config file\n                    (default: hyport.conf)\n    --type=\u003cs\u003e      Backend type(onedrive, ipfs)\n                    (default: ipfs)\n    --debug         Wait for debugger attach after start\n```\n\n## 5. Examples\n\n### 5.1 OneDrive\n\nRun the commands to create a mount point for OneDrive:\n\n```shell\n$ cd $YOUR-TRY-DIR\n$ mdkir onedrive\n$ ./hyport --type=onedrive onedrive\n```\n\nWhen you run the command, there will pop up a browser window to conduct **authorisation** to get permission to access your **OneDrive**. Just enter the account and password to get authorisation.\n\nAfter mounting on oneDrive, then you can **cd** to **onedrive** directory to have a try with posix commands as below:\n\n```shell\n$ cd onedrive\n$ echo \"hello onedrive\" \u003e onedrive.txt\n$ ls \n$ cat onedrive.txt\n$ mkdir foo\n$ cd foo\n$ echo \"onedrive\" \u003e bar.txt\n```\n\n###5.2  Example for Hive IPFS\n\nRun the commands to create a mount point for **Hive IPFS**:\n\n```shell\n$ cd $YOUR-TRY-DIR\n$ mdkir ipfs\n$ ./hyport --type=ipfs ipfs\n```\n\nAfter mounting on **Hive IPFS**, then you can **cd** to **ipfs** directory to have a try with posix commands as below:\n\n```shell\n$ cd ipfs\n$ echo \"hello ipfs\" \u003e ipfs.txt\n$ ls \n$ cat ipfs.txt\n$ mkdir foo\n$ cd foo\n$ echo \"ipfs\" \u003e bar.txt\n```\n\n\n###5.3. Example to copy file from OneDrive to Hive IPFS\n\nHere is a special case we would want to demonstrate that the files in **OneDrive** can be copied to **Hive IPFS** with the following command. \n\nAt first, the following directory structure should be set up as below:\n\n```shell\n|--$YOUR-TRY-DIR\n   |--onedrive\n   |--ipfs\n```\n\nwhere the directories **onedrive** and **ipfs** are both the mount points to **OneDrive** and **Hive IPFS** respectively as created with samples before.\n\nThen run the command to conduct the **copy** file in **onedrive** to **ipfs**:\n\n```shell\n$ cd onedrive\n$ cp onedrive.txt ../ipfs/.\n$ cd ../ipfs/ipfs.txt .\n$ ls \n```\n\nAfter that, you can see file **onedirve.txt** has been copied to **Hive IPFS** network, and **ipfs.txt** has been copied to **OneDrive** cloud drive.\n\n## 6. Notices\n\nFor now, **hyport** cli is still being under development, and there is lots of improvement ahead of us. Any feedbacks would be appreciated.\n\n## 7. License\n\nMIT@stiartsly","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstiartsly%2Fhyport-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstiartsly%2Fhyport-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstiartsly%2Fhyport-cli/lists"}