Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/stiartsly/hyport-cli
Virtual file system to miscellaneous remote cloud storage service.
https://github.com/stiartsly/hyport-cli
fuse ipfs onedrive
Last synced: 2 days ago
JSON representation
Virtual file system to miscellaneous remote cloud storage service.
- Host: GitHub
- URL: https://github.com/stiartsly/hyport-cli
- Owner: stiartsly
- Created: 2019-08-14T09:51:18.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2019-08-20T09:46:33.000Z (over 5 years ago)
- Last Synced: 2023-10-20T23:15:52.455Z (over 1 year ago)
- Topics: fuse, ipfs, onedrive
- Homepage:
- Size: 4.36 MB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Hyport Command Line Tool
========================
## 1. Introduction
Hyport 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:
- OneDrive
- IPFS
## 2. Prerequisites
Currently, the **hyport** command line tool is only supported for **Linux system** (**Ubuntu-16.04** is recommended) and **x86/64** architectures.
And the dependency **libfuse-dev** should be installed before using **hyport**. Run the following command to install it:
```shell
$sudo apt-get install libfuse-dev=2.9.4-1ubuntu3.1
```
or with simple way like:
```shell
$sudo apt-get install libfuse-dev
```
## 3. Deployment
Use the command to clone the repo on your local **Linux**-based machine:
```shell
$ git clone https://github.com/stiartsly/hyport-cli.git
$ cd hyport-cli/bin
```
## 4. Usage
Run the following command to get usage to **hyport** cli:
```shell
$ ./hyport -h
usage: hyport [options]
File-system specific options:
--config= Path of config file
(default: hyport.conf)
--type= Backend type(onedrive, ipfs)
(default: ipfs)
--debug Wait for debugger attach after start
```
## 5. Examples
### 5.1 OneDrive
Run the commands to create a mount point for OneDrive:
```shell
$ cd $YOUR-TRY-DIR
$ mdkir onedrive
$ ./hyport --type=onedrive onedrive
```
When 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.
After mounting on oneDrive, then you can **cd** to **onedrive** directory to have a try with posix commands as below:
```shell
$ cd onedrive
$ echo "hello onedrive" > onedrive.txt
$ ls
$ cat onedrive.txt
$ mkdir foo
$ cd foo
$ echo "onedrive" > bar.txt
```
###5.2 Example for Hive IPFS
Run the commands to create a mount point for **Hive IPFS**:
```shell
$ cd $YOUR-TRY-DIR
$ mdkir ipfs
$ ./hyport --type=ipfs ipfs
```
After mounting on **Hive IPFS**, then you can **cd** to **ipfs** directory to have a try with posix commands as below:
```shell
$ cd ipfs
$ echo "hello ipfs" > ipfs.txt
$ ls
$ cat ipfs.txt
$ mkdir foo
$ cd foo
$ echo "ipfs" > bar.txt
```
###5.3. Example to copy file from OneDrive to Hive IPFS
Here is a special case we would want to demonstrate that the files in **OneDrive** can be copied to **Hive IPFS** with the following command.
At first, the following directory structure should be set up as below:
```shell
|--$YOUR-TRY-DIR
|--onedrive
|--ipfs
```
where the directories **onedrive** and **ipfs** are both the mount points to **OneDrive** and **Hive IPFS** respectively as created with samples before.
Then run the command to conduct the **copy** file in **onedrive** to **ipfs**:
```shell
$ cd onedrive
$ cp onedrive.txt ../ipfs/.
$ cd ../ipfs/ipfs.txt .
$ ls
```
After that, you can see file **onedirve.txt** has been copied to **Hive IPFS** network, and **ipfs.txt** has been copied to **OneDrive** cloud drive.
## 6. Notices
For now, **hyport** cli is still being under development, and there is lots of improvement ahead of us. Any feedbacks would be appreciated.
## 7. License
MIT@stiartsly