/tadpoles-backup

Download images of your kids from tadpoles.com for backup

Primary LanguageGoMIT LicenseMIT

License: MIT GitHub go.mod Go version (branch) GitHub Workflow Status

Tadpoles Image Backup

About

This tool will allow you to save all your child's images at full resolution from tadpoles.com.

Current save back-ends:

  • Local file system

Install

GitHub release (latest by date)

Get latest prebuilt executable from the releases page.

Or use one of these commands:

Linux

$ sudo wget https://tadpoles-backup/releases/latest/download/tadpoles-backup-linux-amd64 -O /usr/local/bin/tadpoles-backup
$ sudo chmod +x /usr/local/bin/tadpoles-backup

OS X

$ sudo curl -Lo /usr/local/bin/tadpoles-backup https://tadpoles-backup/releases/latest/download/tadpoles-backup-darwin-amd64
$ sudo chmod +x /usr/local/bin/tadpoles-backup

Windows

# PowerShell:
$ Invoke-WebRequest -OutFile $env:USERPROFILE\tadpoles-backup.exe https://tadpoles-backup/releases/latest/download/tadpoles-backup-windows-amd64.exe

Usage

IMPORTANT

You MUST have a tadpoles.com account with a tadpoles specific password. You CAN NOT log in to this tool with Google Auth. If you normally log into tadpoles.com with Google/Gmail account verification read these instructions.

# Print help with command details:
$ tadpoles-backup --help

# Get account statistics (requires login)
$ tadpoles-backup stat

# Download images (requires login)
$ tadpoles-backup backup "/a/directory/on/your/machine/"

Development

See the contributing guide here.

Install the Go version defined in go.mod or use goenv to manage Go (as set by .go-version).

# build for your platform only and run.
$ make && bin/tadpoles-backup --help

Notes

tadples-backup caches your login session cookie locally so you are not prompted to enter your password every time you use the tool. It DOES NOT store or retain your actual email or password. Instead it writes a file to your home directory with a temporary authentication cookie which lasts for 2 weeks. This file is located in $HOME/.tadpoles-backup/ and can be deleted whenever you choose.

Inspired By