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.json

COMMANDS:

   help, h  Shows a list of commands or help for one command

GLOBAL 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)