i4tow

Turn any photo folder into a beautiful, shareable gallery in seconds.

Live Demo | View Albums

Why i4tow?

No servers. No databases. No monthly fees. No ads.

i4tow creates stunning photo galleries hosted on GitHub Pages - completely free, forever. One command turns your photo folder into a shareable album with a permanent link.

Perfect for:

• Wedding photographers sharing albums with clients
• Event photographers delivering photos
• Anyone who wants a simple way to share photo collections

Install

npm install -g @rathnasorg/i4tow

Requires Node.js 18+

Quick Start

i4tow /path/to/photos --token YOUR_GITHUB_TOKEN --username YOUR_GITHUB_USERNAME

That's it! Your album is live at:

https://i4tow.date/a/i4tow-[folder-name]

Example

i4tow "/Users/john/Photos/Smith Wedding" --token ghp_xxxx --username johnphoto

Creates: https://i4tow.date/a/i4tow-SmithWedding

Batch Mode

Upload multiple albums at once:

i4tow /Photos/2024 --batch --token YOUR_TOKEN --username YOUR_USERNAME

/Photos/2024/
  ├── Johnson Wedding/     → i4tow-JohnsonWedding
  ├── Smith Anniversary/   → i4tow-SmithAnniversary
  └── Corporate Event/     → i4tow-CorporateEvent

Options

i4tow <folder> [options]

Options:
  -t, --token      GitHub personal access token (required)
  -u, --username   GitHub username (required)
  -d, --dry-run    Preview without creating albums
  -b, --batch      Create album for each subfolder
  -s, --single     Treat entire folder as one album
  -h, --help       Show help

Features

Gallery View

Clean, responsive grid that looks great on any device.

Slideshow Mode

Auto-playing slideshow with shuffle - perfect for events or big screens.

Slideshow All

Play through ALL your albums at once - great for portfolios.

View All Albums

See every album at: https://i4tow.date/p/YOUR_USERNAME

Easy Sharing

Direct links + QR codes for instant sharing with clients.

Supported Formats

• JPEG (.jpg, .jpeg)
• PNG (.png)
• HEIC (.heic) - iPhone photos
• WebP (.webp)
• GIF (.gif)

Getting a GitHub Token

1. Go to GitHub Settings > Developer Settings > Personal Access Tokens
2. Generate new token (classic) with repo scope
3. Copy and use with --token

Detailed guide

Need Help?

• Email: [email protected]
• Want to self-host? We can help!

Made with photographers in mind.