oliverklukas / puffin-transfer

Reverse engineered iCloud for Unix systems in Golang.

Puffin Transfer

A reverese engineered iCloud solution for Unix systems written in Golang. Goal is to automatically rotate unused, unwanted and unnecessary files out of your system into a cloud of your choice. Current state supports rotation of identified files into a GCP firestore instance upon command. WIP - use with caution.

Dependencies

• Golang: ^1.20.4
• Access to cloud system of your choice, i.e. GCP - Firestore

Build instructions

1. Retrieve the repository

git clone https://github.com/OliverKlukas/puffin-transfer.git
cd puffin-transfer

3. Build the binary with

go build -o puffin-transfer cmd/cli/main.go

3. Run the binary with

./puffin-transfer

Project structure

cmd/cli

• main tui for user input

config

• configuration of static properties

internal/firestore

• connects to firestore in GCP and uploads/downloads files
• requires service account json file
• stored files are saved in the files collection for now

internal/fileanalyzer

• Walks a file tree and analyzes all files on different criteria. If a file violates a rule, it is transferred to the store.
• Supported criteria currently are: file size and duplicate files

puffin-transfer's Issues

Change TUI to Bubble Tea application

Add rule based exemptions to which files are allowed to be autotransferred

Make sure no metadata files are transferred

Transfer complete file including meta-data & fix unique keys

Create unique ID for each file to fix relative file path issue

Add persistence functionality of files that are rotated out

Expected behavior:

1. Files that are supposed to be transferred out are deleted
2. A reference file with the same name is left at the deletion location
3. Once the reference file is executed, a script retrieves the file back and deletes it in the database

Add option to analyze to last modified timestamp of files