{"id":15487110,"url":"https://github.com/sakebook/pbssc","last_synced_at":"2025-08-24T06:09:26.702Z","repository":{"id":48057459,"uuid":"385663346","full_name":"sakebook/pbssc","owner":"sakebook","description":"You can get the device image from the CLI and copy it to the clipboard.","archived":false,"fork":false,"pushed_at":"2025-03-25T11:28:01.000Z","size":3859,"stargazers_count":5,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-25T12:30:38.793Z","etag":null,"topics":["adb","android","capture","cli","clipboard","command-line-tool","homebrew","homebrew-tap","ios","iphone","productivity","screenshot"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sakebook.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}},"created_at":"2021-07-13T16:09:26.000Z","updated_at":"2025-03-25T11:28:06.000Z","dependencies_parsed_at":"2022-08-12T17:40:31.112Z","dependency_job_id":null,"html_url":"https://github.com/sakebook/pbssc","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sakebook%2Fpbssc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sakebook%2Fpbssc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sakebook%2Fpbssc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sakebook%2Fpbssc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sakebook","download_url":"https://codeload.github.com/sakebook/pbssc/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247535210,"owners_count":20954571,"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":["adb","android","capture","cli","clipboard","command-line-tool","homebrew","homebrew-tap","ios","iphone","productivity","screenshot"],"created_at":"2024-10-02T06:21:23.954Z","updated_at":"2025-08-24T06:09:26.671Z","avatar_url":"https://github.com/sakebook.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# pbssc\n\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![macOS](https://img.shields.io/badge/platform-macOS-lightgrey.svg)](https://www.apple.com/macos/)\n\n**pbssc** (Provide screenshot and copy to clipboard) is a command-line tool that captures screenshots from connected Android and iOS devices and automatically copies them to your macOS clipboard.\n\nPerfect for developers, QA engineers, and designers who frequently need to capture and share device screenshots during development and testing workflows.\n\n## Features\n\n- **Multi-platform support**: Capture screenshots from both Android and iOS devices\n- **Automatic clipboard integration**: Screenshots are automatically copied to macOS clipboard\n- **File saving**: Save screenshots to a specified directory with timestamp\n- **Simple CLI interface**: Easy-to-use command-line options\n- **Fast and lightweight**: Minimal dependencies and quick execution\n\n## Demo\n\nhttps://user-images.githubusercontent.com/729101/128733918-10f68291-c746-4413-84d7-2aab61345fa4.mp4\n\n## Requirements\n\n- **macOS only** (tested on macOS 10.15+)\n- **Android devices**: [Android Debug Bridge (adb)](https://developer.android.com/studio/command-line/adb)\n- **iOS devices**: [libimobiledevice](https://github.com/libimobiledevice/libimobiledevice)\n\n## Installation\n\n### Homebrew (Recommended)\n\n```bash\nbrew tap sakebook/tap \u0026\u0026 brew install pbssc\n```\n\n### Manual Installation\n\n1. Download the `pbssc` script from this repository\n2. Make it executable:\n   ```bash\n   chmod +x pbssc\n   ```\n3. Move it to a directory in your PATH:\n   ```bash\n   sudo mv pbssc /usr/local/bin/\n   ```\n\n### Dependencies Setup\n\n#### For Android devices:\n```bash\n# Install Android SDK platform tools\nbrew install android-platform-tools\n```\n\n#### For iOS devices:\n```bash\n# Install libimobiledevice\nbrew install libimobiledevice\n```\n\n## Setup\n\nSet the environment variable `PBSSC_IMAGE_PATH` to specify where screenshots should be saved:\n\n```bash\nexport PBSSC_IMAGE_PATH=/path/to/your/screenshots\n```\n\nAdd this to your shell profile (`.bashrc`, `.zshrc`, etc.) to make it permanent:\n\n```bash\necho 'export PBSSC_IMAGE_PATH=/path/to/your/screenshots' \u003e\u003e ~/.zshrc\n```\n\n## Usage\n\n### Basic Commands\n\n#### Capture from Android device\n```bash\npbssc -a\n```\nCaptures a screenshot from the connected Android device, saves it, and copies to clipboard.\n\n#### Capture from iOS device\n```bash\npbssc -i\n```\nCaptures a screenshot from the connected iOS device, saves it, and copies to clipboard.\n\n#### Save screenshots from all connected devices\n```bash\npbssc -s\n```\nCaptures screenshots from all connected devices and saves them (without copying to clipboard).\n\n### Advanced Usage\n\n#### Custom filename\n```bash\npbssc -a my-custom-screenshot.png\npbssc -i app-login-screen.png\n```\n\n#### Help\n```bash\npbssc -h\n```\n\n### Example Workflow\n\n1. Connect your Android or iOS device via USB\n2. Enable USB debugging (Android) or trust the computer (iOS)\n3. Run the appropriate command:\n   ```bash\n   # For Android\n   pbssc -a\n   \n   # For iOS\n   pbssc -i\n   ```\n4. The screenshot is automatically saved and copied to your clipboard\n5. Paste anywhere with `Cmd+V`\n\n## Troubleshooting\n\n### Common Issues\n\n#### \"adb command not found\"\n```bash\n# Install Android platform tools\nbrew install android-platform-tools\n\n# Or add Android SDK to PATH\nexport PATH=$PATH:$ANDROID_HOME/platform-tools\n```\n\n#### \"idevicescreenshot command not found\"\n```bash\n# Install libimobiledevice\nbrew install libimobiledevice\n```\n\n#### \"Connected android device not found\"\n- Ensure USB debugging is enabled on your Android device\n- Check device connection: `adb devices`\n- Try reconnecting the device\n\n#### \"Connected ios device not found\"\n- Ensure you've trusted the computer on your iOS device\n- Check device connection: `idevice_id -l`\n- Try reconnecting the device\n\n#### \"Please set the PBSSC_IMAGE_PATH environment variable\"\n```bash\nexport PBSSC_IMAGE_PATH=/path/to/your/screenshots\nmkdir -p $PBSSC_IMAGE_PATH\n```\n\n## Development\n\n### Prerequisites\n- macOS development environment\n- Bash shell\n- Connected Android/iOS devices for testing\n\n### Testing\n```bash\n# Test Android functionality\nadb devices\n./pbssc -a\n\n# Test iOS functionality\nidevice_id -l\n./pbssc -i\n```\n\n### File Structure\n```\npbssc/\n├── pbssc           # Main executable script\n├── README.md       # This file\n├── LICENSE         # Apache 2.0 License\n└── .gitignore      # Git ignore rules\n```\n\n## Contributing\n\nContributions are welcome! Here's how you can help:\n\n1. **Fork** the repository\n2. **Create** a feature branch (`git checkout -b feature/amazing-feature`)\n3. **Commit** your changes (`git commit -m 'Add some amazing feature'`)\n4. **Push** to the branch (`git push origin feature/amazing-feature`)\n5. **Open** a Pull Request\n\n### Contribution Guidelines\n- Follow existing code style\n- Test your changes on both Android and iOS devices\n- Update documentation as needed\n- Add tests for new features\n\n## License\n\nThis project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.\n\n## Acknowledgments\n\n- [Android Debug Bridge (adb)](https://developer.android.com/studio/command-line/adb) for Android device communication\n- [libimobiledevice](https://github.com/libimobiledevice/libimobiledevice) for iOS device communication\n- The open-source community for inspiration and support\n\n## Support\n\n- **Issues**: [GitHub Issues](https://github.com/sakebook/pbssc/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/sakebook/pbssc/discussions)\n- **Homepage**: [https://github.com/sakebook/pbssc](https://github.com/sakebook/pbssc)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsakebook%2Fpbssc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsakebook%2Fpbssc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsakebook%2Fpbssc/lists"}