{"id":22582995,"url":"https://github.com/jerdog/bluesky-notify","last_synced_at":"2025-04-10T01:53:32.695Z","repository":{"id":264245786,"uuid":"892816215","full_name":"jerdog/bluesky-notify","owner":"jerdog","description":"Have your own notification system for following Bluesky accounts.","archived":false,"fork":false,"pushed_at":"2024-12-28T18:32:17.000Z","size":243,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-07T13:05:02.773Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jerdog.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2024-11-22T20:47:16.000Z","updated_at":"2025-03-25T10:34:11.000Z","dependencies_parsed_at":"2024-12-16T02:18:20.352Z","dependency_job_id":"ff3df0a7-3b28-46b4-939d-0be13de917ea","html_url":"https://github.com/jerdog/bluesky-notify","commit_stats":null,"previous_names":["jerdog/bluesky-notify"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jerdog%2Fbluesky-notify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jerdog%2Fbluesky-notify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jerdog%2Fbluesky-notify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jerdog%2Fbluesky-notify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jerdog","download_url":"https://codeload.github.com/jerdog/bluesky-notify/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248142938,"owners_count":21054671,"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","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":[],"created_at":"2024-12-08T06:13:10.327Z","updated_at":"2025-04-10T01:53:32.662Z","avatar_url":"https://github.com/jerdog.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bluesky Notify\n\nA cross-platform desktop notification system for Bluesky. Monitor and receive notifications from your favorite Bluesky accounts.\n\n[![Version](https://img.shields.io/badge/version-0.5.2-blue.svg)](https://github.com/jerdog/bluesky-notify)\n[![Python](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)\n[![Flask](https://img.shields.io/badge/Flask-3.1.0-blue)](https://pypi.org/project/Flask/)\n[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)\n\nhttps://pypi.org/project/bluesky-notify/\n\n## Features\n\n- Monitor multiple Bluesky accounts for new posts\n- Desktop notifications support across platforms (macOS, Linux, Windows)\n- Daemon mode for continuous monitoring\n- Web interface for easy account management\n- XDG-compliant configuration storage\n- SQLite database for reliable post tracking\n- Cross-platform compatibility\n- Consistent CLI interface with clear version and configuration information\n- Comprehensive logging system with rotation and separate error logs\n\n## Installation\n\n- From local / repo download\n```bash\npip install bluesky-notify\n```\n\n- From PyPi\n```bash\n\nTo verify the installation:\n```bash\nbluesky-notify --version\n```\n\nExample output:\n```\nBluesky Notify v0.5.1\nConfig: /Users/username/.local/share/bluesky-notify\n\nA cross-platform desktop notification system for Bluesky. Monitor and receive notifications from your favorite Bluesky accounts.\n\nUsage: bluesky-notify [OPTIONS] COMMAND [ARGS]...\n\nRun 'bluesky-notify start --daemon' to install and run as a system service.\n\nOptions:\n  --version     Show version and exit\n  --help        Show this message and exit\n\nCommands:\n  add          Add a Bluesky account to monitor.\n  list         List all monitored Bluesky accounts and their notification...\n  remove       Remove a Bluesky account from monitoring.\n  settings     View or update application settings.\n  start        Start the notification service.\n  status       View the current status of the service.\n  stop         Stop the notification service.\n  toggle       Toggle monitoring status for a Bluesky account.\n  update       Update notification preferences for a monitored account.\n```\n\n## Configuration\n\nThe application uses the XDG Base Directory Specification for storing its data:\n\n- Configuration: `~/.config/bluesky-notify/`\n- Data: `~/.local/share/bluesky-notify/`\n- Cache: `~/.cache/bluesky-notify/`\n- Logs:\n  - macOS: `~/Library/Logs/bluesky-notify/`\n  - Linux: `~/.local/share/bluesky-notify/logs/`\n\n### Port Configuration\n\nThe web interface runs on port 3000 by default. On macOS, port 5000 is avoided as it's reserved for AirPlay. You can change the port using:\n\n```bash\nbluesky-notify settings --port NUMBER\n```\n\n## Usage\n\n### Starting the Service\n\nStart the service with debug logging:\n```bash\nbluesky-notify start --log-level DEBUG\n```\n\nStart as a system service:\n```bash\nbluesky-notify start --daemon\n```\n\n### Command Help\n\nTo see all available commands and options:\n```bash\nbluesky-notify --help\n```\n\n### Adding an Account to Monitor\n\n```bash\nbluesky-notify add username.bsky.social\n```\n\nNote: The handle should be provided without the '@' symbol.\n\nOptions:\n- `--desktop/--no-desktop`: Enable/disable desktop notifications (default: enabled)\n\n### Listing Monitored Accounts\n\n```bash\nbluesky-notify list\n```\n\n### Managing Accounts\n\nToggle monitoring for an account:\n```bash\nbluesky-notify toggle username.bsky.social\n```\n\nRemove an account:\n```bash\nbluesky-notify remove username.bsky.social\n```\n\nUpdate notification preferences:\n```bash\nbluesky-notify update username.bsky.social --desktop/--no-desktop\n```\n\n## Logging\n\nThe application uses a comprehensive logging system:\n\n- Log files are stored in platform-specific locations:\n  - macOS: `~/Library/Logs/bluesky-notify/`\n  - Linux: `~/.local/share/bluesky-notify/logs/`\n\n- Two log files are maintained:\n  - `bluesky-notify.log`: General application logs (INFO level and above)\n  - `bluesky-notify.error.log`: Error logs only (ERROR level)\n\n- Log rotation is enabled:\n  - Maximum file size: 1MB\n  - Keeps up to 5 backup files\n  - Rotated files are named with numerical suffixes (e.g., bluesky-notify.log.1)\n\n- Debug logging can be enabled with:\n  ```bash\n  bluesky-notify start --log-level DEBUG\n  ```\n\n## Development\n\n### Requirements\n\n- Python 3.9 or higher\n- Dependencies listed in pyproject.toml\n\n### Setting Up Development Environment\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/jerdog/bluesky-notify.git\ncd bluesky-notify\n```\n\n2. Install development dependencies:\n```bash\npip install -e \".[dev]\"\n```\n\n3. Run tests:\n```bash\npytest\n```\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## Support\n\nIf you encounter any issues or have questions, please file an issue on the GitHub repository.\n\n## Version History\n\n- 0.5.2: Fixed weird error where text of notification wasn't being passed\n- 0.5.1: Remove docker functionality\n- 0.5.0: Cleanup codebase, remove old functionality\n- 0.4.4: Fix erratic notification issues\n- 0.4.2: Enhance monitoring + logging\n- 0.4.1: Validate Docker container image builds correctly, make CLI co-exist\n- 0.4.0: Add web interface to daemon + terminal mode\n- 0.3.0: Add daemon mode, web interface, and improved CLI help text\n- 0.2.7: Fixed CLI output formatting and help text organization\n- 0.2.6: Enhanced CLI interface with consistent version and config display\n- 0.2.5: Improved help text formatting and command output\n- 0.2.4: Added version and config information to all commands\n- 0.2.3: Refined CLI presentation and version display\n- 0.2.0: Initial public release\n\n## Troubleshooting\n\n1. **Version Check**\n   - Run `bluesky-notify --version` to verify the installed version\n   - Make sure you have the latest version installed\n\n2. **No Notifications**\n   - Check if desktop notifications are enabled in your system\n   - Verify the notification service is running\n   - Check logs in `~/.local/share/bluesky-notify/logs/`\n\n3. **API Errors**\n   - Verify Bluesky handles are entered correctly (without '@' symbol)\n   - Check your internet connection\n   - Ensure the Bluesky API is accessible\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjerdog%2Fbluesky-notify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjerdog%2Fbluesky-notify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjerdog%2Fbluesky-notify/lists"}