{"id":28798136,"url":"https://github.com/anubhavitis/homebrew-peeksy","last_synced_at":"2026-05-08T04:02:14.480Z","repository":{"id":299249244,"uuid":"1000786692","full_name":"anubhavitis/homebrew-peeksy","owner":"anubhavitis","description":"screenshot name automation tool for macos","archived":false,"fork":false,"pushed_at":"2025-08-18T11:43:19.000Z","size":73,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-18T13:28:39.211Z","etag":null,"topics":["homebrew","open-source","openai","screenshot","screenshot-utility","vision-api"],"latest_commit_sha":null,"homepage":"https://anubhavitis.github.io/peeksy/","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/anubhavitis.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-12T10:15:56.000Z","updated_at":"2025-08-18T11:43:22.000Z","dependencies_parsed_at":"2025-06-15T15:52:55.536Z","dependency_job_id":"81276635-85cb-400a-950f-74a3ac8cf3d6","html_url":"https://github.com/anubhavitis/homebrew-peeksy","commit_stats":null,"previous_names":["anubhavitis/homebrew-peeksy"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/anubhavitis/homebrew-peeksy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anubhavitis%2Fhomebrew-peeksy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anubhavitis%2Fhomebrew-peeksy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anubhavitis%2Fhomebrew-peeksy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anubhavitis%2Fhomebrew-peeksy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/anubhavitis","download_url":"https://codeload.github.com/anubhavitis/homebrew-peeksy/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anubhavitis%2Fhomebrew-peeksy/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271745472,"owners_count":24813499,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-23T02:00:09.327Z","response_time":69,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["homebrew","open-source","openai","screenshot","screenshot-utility","vision-api"],"created_at":"2025-06-18T05:02:01.252Z","updated_at":"2026-05-08T04:02:09.457Z","avatar_url":"https://github.com/anubhavitis.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"assets/peeksy.png\" width=\"150\" height=\"150\" alt=\"Peeksy Logo\" /\u003e\n\n# Peeksy\n\nA Rust-based tool that automatically renames screenshots and images using OpenAI's GPT-4 Vision API. The tool analyzes image content and generates descriptive, meaningful filenames following a consistent naming convention.\n\nDemo video [here](https://x.com/anubhavitis/status/1922303569639702976)\n\n## Features\n\n- Automatic image analysis using GPT-4 Vision API\n- Intelligent context recognition (screenshots, album covers, artwork, posters, UI elements)\n- Consistent filename formatting (lowercase, hyphen-separated)\n- Real-time file monitoring and automatic renaming\n- Configurable naming rules through prompt template\n\n\n## Requirements\n\n- Rust (latest stable version)\n- OpenAI API key with access to GPT-4 Vision API\n\nNote: Peeksy will prompt you to enter OpenApi key them during first run. The values will be automatically saved for future use.\n\n## Installation\n\n```\nbrew tap anubhavitis/peeksy\n\nbrew install peeksy\n\npeeksy start\n```\n\n## How to Use\n\nOnce you've completed the installation steps above, Peeksy will automatically monitor your screenshots directory. Here's what happens:\n\n1. **Start the Service**\n   ```bash\n   peeksy start\n   ```\n\n2. **Take Screenshots**\n   - Use your system's screenshot shortcut (⌘⇧3 or ⌘⇧4 on macOS)\n\n3. **Watch the Magic**\n   - Peeksy will detect new screenshots\n   - Analyze the content using GPT-4 Vision\n   - Automatically rename them with descriptive names\n   - Original files are preserved with the new names\n\n4. **Customize (Optional)**\n   ```bash\n   # View your current prompt template\n   peeksy view-prompt-file\n\n   # Update the prompt template\n   peeksy update-prompt-file-path \"path/to/your/custom-prompt.txt\"\n   ```\n\nThat's it! Peeksy will continue running in the background, automatically renaming your screenshots as you take them.\n\n## Commands\n\nPeeksy provides several commands to manage the daemon and configuration:\n\n### Daemon Management\n- `start` - Start the Peeksy daemon\n- `stop` - Stop the running Peeksy daemon\n- `restart` - Restart the Peeksy daemon\n- `status` - Check if the Peeksy daemon is running and get its PID\n\n### Configuration Management\n- `current-config` - Display the current configuration in JSON format\n- `view-prompt-file` - Display the contents of the current prompt file\n- `update-api-key \u003cvalue\u003e` - Update the OpenAI API key\n- `update-prompt-file-path \u003cvalue\u003e` - Update the path to the prompt template file\n\n### Examples\n```bash\n# Start the Peeksy daemon\npeeksy start\n\n# Check if the daemon is running and get its PID\npeeksy status\n\n# Stop the running daemon\npeeksy stop\n\n# Restart the daemon (useful after configuration changes)\npeeksy restart\n\n# View your current configuration settings\npeeksy current-config\n\n# View the contents of your prompt template file\npeeksy view-prompt-file\n\n# Update your OpenAI API key\npeeksy update-api-key \"sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"\n\n# Update the path to your prompt template file\npeeksy update-prompt-file-path \"/path/to/your/custom-prompt.txt\"\n\n# Run the daemon directly (usually not needed, use 'start' instead)\npeeksy daemon\n```\n\nNote: The daemon must be running for Peeksy to monitor and rename your screenshots. Use `peeksy status` to verify the daemon is running.\n\n# Support \u0026 Queries\n\nFor any questions, issues, or feature requests, please reach out to:\n- [Email](mailto:anubhavitis@gmail.com)\n- GitHub Issues: [Create an issue](https://github.com/anubhavitis/peeksy/issues)\n\nFeel free to:\n- Report bugs\n- Suggest new features\n- Ask for help with configuration\n- Share your experience with Peeksy\n   ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanubhavitis%2Fhomebrew-peeksy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fanubhavitis%2Fhomebrew-peeksy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanubhavitis%2Fhomebrew-peeksy/lists"}