Files
skywipe/README.md

2.3 KiB

Skywipe

Skywipe is a work-in-progress Python 3.13+ CLI that helps you wipe data from your Bluesky account using the AT Protocol SDK.

Warning

This tool performs destructive operations. Only use it if you intend to erase data from your Bluesky account.

Requirements

Check pyproject.toml.

You can use uv to install dependencies:

git clone https://git.kharec.info/Kharec/skywipe.git
cd skywipe
uv sync

How to run

When installation will be worked out, you'll be able to :

skywipe all            # target everything
skywipe configure      # create configuration
skywipe posts          # delete posts
skywipe medias         # delete posts with medias
skywipe likes          # delete likes
skywipe reposts        # delete reposts
skywipe follows        # delete follows
skywipe bookmarks      # delete follows

While it's being developed, you can use the tool using uv :

uv run main.py all            # target everything
uv run main.py configure      # create configuration
uv run main.py posts          # delete posts
uv run main.py medias         # delete posts with medias
uv run main.py likes          # delete likes
uv run main.py reposts        # delete reposts
uv run main.py follows        # delete follows
uv run main.py bookmarks      # delete bookmarks

Configuration

If you run the tool for the first time, it will prompt you to use skywipe configure to create the configuration file, which is located in ~/.config/skywipe/config.yml :

handle: your_handle
password: your_password
batch_size: 10
delay: 1
verbose: true

BE SURE TO USE A BLUESKY APP PASSWORD FOR OBVIOUS SECURITY REASONS.

Roadmap

  • build cli parameter management
  • handle configuration logic
  • sign in to at protocol
  • delete posts in batch
  • only delete posts with media
  • remove likes
  • remove reposts
  • unfollow accounts
  • remove bookmarks
  • make all run the other commands
  • add simple progress and logging
  • add safeguards like confirmations and clear dry-run info

Once it's done, we'll think:

  • decent code architecture
  • installation and run process

License

This project is licensed under the GPLv3+ License. See the LICENSE file for details.