migratesky/README.md

# migratesky 🦋
handy tools for migrating your bluesky account to a new DID!

if you're not handy with go, you can download release builds in the releases tab.

## build
```sh
go build -o migratesky .
```

## usage
```sh
migratesky <-from <identifier>> <-frompass <password>> <-to <identifier>> <-topass <password>> <-pds <pds-url>> [collections...]
```

### example
```sh
# migrate the profile, follows, and preferences from @old.example.org to @new.example.org:
migratesky -from old.example.org -frompass $SRC_PASSWORD \
    -to new.example.org -topass $DEST_PASSWORD \
    -pds https://my.awesome.pds.example.org \
    profile follows preferences
```

### required arguments:
- `-from <identifier>`: the source account handle or DID.
- `-frompass <password>`: the source account password.
- `-to <identifier>`: the destination account handle or DID.
- `-topass <password>`: the destination account password.
- `-pds <pds-url>`: the full https:// url of the destination account's PDS.

### collections:
- `profile`: imports account profile, including avatar, banner, display name, and description.
- `follows`: imports all following accounts.
- `preferences`: imports account preferences; including feeds, labeller settings, and content filters.

### optional arguments:
- `-frompds <pds-url>`: the source account's PDS url (defaults to the value of -pds).
- `-dryrun`: does not import follow records; good for sanity testing!
- `-v`: verbose output
- `-help`: shows this help message.