Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ipfs/ipget
Retrieve files over IPFS and save them locally.
https://github.com/ipfs/ipget
Last synced: about 1 month ago
JSON representation
Retrieve files over IPFS and save them locally.
- Host: GitHub
- URL: https://github.com/ipfs/ipget
- Owner: ipfs
- License: mit
- Created: 2015-09-25T06:02:08.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2024-09-12T20:55:00.000Z (about 2 months ago)
- Last Synced: 2024-09-29T20:33:23.084Z (about 1 month ago)
- Language: Shell
- Homepage:
- Size: 3.81 MB
- Stars: 392
- Watchers: 24
- Forks: 54
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-peer-to-peer - ipget
- awesome-starred - ipfs/ipget - Retrieve files over IPFS and save them locally. (others)
README
# ipget
[![](https://img.shields.io/badge/made%20by-Protocol%20Labs-blue.svg?style=flat-square)](https://protocol.ai)
[![](https://img.shields.io/badge/project-IPFS-blue.svg?style=flat-square)](https://ipfs.io/)> wget for IPFS: retrieve files over IPFS and save them locally.
`ipget` is a standalone program analogous to [GNU `wget`](https://www.gnu.org/software/wget/). Unlike wget though, `ipget` specializes in downloading files and directory structures from the [IPFS network](https://ipfs.io).
`ipget` includes its own IPFS node, so you don't need IPFS installed on your
system. This makes it ideal for users and projects that want a simple utility
for whenever they want to retrieve files from IPFS.## Install
Download a binary for your platform from [IPFS Distributions](https://dist.ipfs.io/#ipget).
### Install From Source
```
$ go install github.com/ipfs/ipget@latest
```### Example
Find a fun IPFS address and `ipget` away!
```
$ ipget QmQ2r6iMNpky5f1m4cnm3Yqw8VSvjuKpTcK1X7dBR1LkJF/cat.gif -o nyan.gif
```
or with an `/ipfs` prefix:
```
$ ipget -o nyan.gif /ipfs/QmQ2r6iMNpky5f1m4cnm3Yqw8VSvjuKpTcK1X7dBR1LkJF/cat.gif
```
or even IPNS addresses (note this is an IPNS address example and does not work):
```
$ ipget /ipns/QmQG1kwx91YQsGcsa9Z1p6BPJ3amdiSLLmsmAoEMwbX61b/files/cat.gif
```## Usage
```
NAME:
ipget - Retrieve and save IPFS objects.USAGE:
ipget [global options] command [command options] [arguments...]VERSION:
see version.jsonCOMMANDS:
help, h Shows a list of commands or help for one commandGLOBAL OPTIONS:
--output value, -o value specify output location
--node value, -n value specify ipfs node strategy ("local", "spawn", "temp" or "fallback") (default: "fallback")
--peers value, -p value specify a set of IPFS peers to connect to
--progress show a progress bar (default: false)
--help, -h show help (default: false)
--version, -v print the version (default: false)
```## Contribute
Feel free to join in. All welcome. Open an [issue](https://github.com/ipfs/ipget/issues)!
This repository falls under the IPFS [Code of Conduct](https://github.com/ipfs/community/blob/master/code-of-conduct.md).
[![](https://cdn.rawgit.com/jbenet/contribute-ipfs-gif/master/img/contribute.gif)](https://github.com/ipfs/community/blob/master/CONTRIBUTING.md)
## License
[MIT](LICENSE)