PinMe

PinMe is a simple and easy-to-use command-line tool for uploading files and directories to the IPFS network.

Features

• 🚀 Quickly upload files and directories to IPFS
• 📂 Support for various file types and sizes
• 📊 View and manage upload history
• 🔗 Automatically generate accessible IPFS links
• 🌐 Preview uploaded content

Installation

Using npm

npm install -g pinme

Using yarn

yarn global add pinme

Usage

Upload files or directories

# Interactive upload
pinme upload

# Specify path directly
pinme upload /path/to/file-or-directory

View upload history

# Show the last 10 upload records
pinme list

# Or use the shorthand command
pinme ls

# Limit the number of records shown
pinme list -l 5

# Clear all upload history
pinme list -c

Get help

# Display help information
pinme help

Command Details

upload

Upload a file or directory to the IPFS network.

pinme upload [path]

Options:

• path: Path to the file or directory to upload (optional, if not provided, interactive mode will be entered)

Examples:

# Interactive upload
pinme upload

# Upload a specific file
pinme upload ./example.jpg

# Upload an entire directory
pinme upload ./my-website

list / ls

Display upload history.

pinme list [options]
pinme ls [options]

Options:

• -l, --limit <number>: Limit the number of records displayed
• -c, --clear: Clear all upload history

Examples:

# Show the last 10 records
pinme list

# Show the last 5 records
pinme ls -l 5

# Clear all history records
pinme list -c

help

Display help information.

pinme help [command]

Options:

• command: The specific command to view help for (optional)

Examples:

# Display general help
pinme help

Upload Limits

• Single file size limit: 100MB
• Total directory size limit: 500MB

File Storage

Uploaded files are stored on the IPFS network and accessible through the Glitter Protocol's IPFS gateway. After a successful upload, you will receive:

1. IPFS hash value
2. Accessible URL link

Log Locations

Logs and configuration files are stored in:

• Linux/macOS: ~/.pinme/
• Windows: %USERPROFILE%\.pinme\

License

MIT License - See the LICENSE file for details

Contact Us

If you have questions or suggestions, please contact us through:

• GitHub Issues: https://github.com/glitternetwork/pinme/issues
• Email: pinme@glitterprotocol.io

---

Developed and maintained by the Glitter Protocol team