https://github.com/shlomomdahan/cleanshot

Automatically detect and rename screenshots
https://github.com/shlomomdahan/cleanshot

ai llm macos

Last synced: 3 months ago
JSON representation

Automatically detect and rename screenshots

• Host: GitHub
• URL: https://github.com/shlomomdahan/cleanshot
• Owner: shlomomdahan
• License: mit
• Created: 2025-04-28T20:31:26.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-05-05T18:27:11.000Z (about 1 year ago)
• Last Synced: 2026-01-05T11:13:44.768Z (6 months ago)
• Topics: ai, llm, macos
• Language: Python
• Homepage:
• Size: 7.98 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# cleanshot 📸

[![PyPI version](https://badge.fury.io/py/cleanshot.svg)](https://badge.fury.io/py/cleanshot)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Cleanshot monitors your macOS Screenshots folder and automatically renames screenshots using OpenAI.

![Description](./.github/demo.gif)

## 🔧 Installation

```bash

pip install cleanshot

```

## 🎮 Usage

#### Start cleanshot

```bash

cleanshot

```

#### Stop cleanshot

```bash

cleanshot stop

```

#### View help docs

```bash

cleanshot --help

```

## ⚙️ Settings

### **Supported LLM Providers:**

- OpenAI

You can update your API keys and provider settings by running:

```bash

cleanshot --setup

```

### OpenAI

To use OpenAI, you need an OpenAI account and a subscription. You can create an API key on [this page](https://platform.openai.com/settings/organization/api-keys).

## 🤝 Contributing

Contributions are welcome! Feel free to open issues or submit pull requests.

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.