{"id":13631475,"url":"https://github.com/raiyanyahya/screenshot","last_synced_at":"2026-01-17T17:39:29.791Z","repository":{"id":143330363,"uuid":"614939539","full_name":"raiyanyahya/screenshot","owner":"raiyanyahya","description":"✂ A github action that takes full screen scrolling screenshots of custom or preview urls and uploads them to dropbox.","archived":false,"fork":false,"pushed_at":"2023-03-18T12:59:27.000Z","size":24,"stargazers_count":13,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-14T15:02:06.122Z","etag":null,"topics":["dropbox","github","github-actions","pull-requests","python","screenshot"],"latest_commit_sha":null,"homepage":"","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/raiyanyahya.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":"raiyanyahya"}},"created_at":"2023-03-16T16:10:14.000Z","updated_at":"2024-01-26T00:55:17.000Z","dependencies_parsed_at":"2023-12-21T16:54:24.782Z","dependency_job_id":null,"html_url":"https://github.com/raiyanyahya/screenshot","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raiyanyahya%2Fscreenshot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raiyanyahya%2Fscreenshot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raiyanyahya%2Fscreenshot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raiyanyahya%2Fscreenshot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/raiyanyahya","download_url":"https://codeload.github.com/raiyanyahya/screenshot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249316033,"owners_count":21249879,"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":["dropbox","github","github-actions","pull-requests","python","screenshot"],"created_at":"2024-08-01T22:02:26.978Z","updated_at":"2026-01-16T10:48:22.019Z","avatar_url":"https://github.com/raiyanyahya.png","language":"Python","funding_links":["https://github.com/sponsors/raiyanyahya"],"categories":["Python"],"sub_categories":[],"readme":"# ✂ screenshot to dropbox\nThis GitHub Action takes a `full screen scrolling` screenshot of a given URL, uploads it to Dropbox and posts the image url as a comment on the associated pull request. It's useful for visualizing changes in a UI project, previewing a deployed staging environment, or any situation where a visual representation of the changes in a PR is helpful.\n\n[![HXpiPI4.md.png](https://iili.io/HXpiPI4.md.png)](https://freeimage.host/i/HXpiPI4)\n\n## Prerequisites\nTo use this action, you must have the following:\n\nA GitHub repository with a workflow that triggers on pull request events and a DropBox Access Token. The DropBox token should have the `files.content.write` and the `sharing.write` permission.\n\n## Recommended permissions\n\nFor the execution of this action, it must be able to comment on a PR.  \nThis can be achieved with the following [configuration in the action](https://docs.github.com/en/actions/reference/workflow-syntax-for-github-actions#permissions) if the permissions are restricted:\n\n```yaml\npermissions:\n  issues: write\n  pull-requests: write\n```\n\n## Usage\nTo use this action in your workflow, follow these steps:\n\n1.Navigate to the GitHub Marketplace and search for \"Screenshot Action\" or visit the action's GitHub Marketplace page directly.\n\n2.Click the \"Use latest version\" button to add the action to your repository.\n\n3.In your repository, create a .github/workflows directory if it doesn't already exist.\n\n4.Add a new workflow file, e.g., screenshot_on_pr.yml.\n\n5Include the following example workflow in your new file, replacing your-username with the action creator's GitHub username and https://example.com with the desired URL to capture a screenshot of:\n\n```\nname: Screenshot on PR\n\non:\n  pull_request:\n    types:\n      - opened\n      - synchronize\n\njobs:\n  screenshot:\n    runs-on: ubuntu-latest\n\n    steps:\n    - name: Checkout repository\n      uses: actions/checkout@v2\n\n    - name: Take screenshot and post it on the PR\n      uses: raiyanyahya/screenshot-action@master\n      with:\n        url: 'https://example.com'\n        dropbox_token: ${{ secrets.DROPBOX_TOKEN }}\n      env:\n        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n```\nThis example workflow runs on pull request events with opened and synchronize types. It checks out the repository, captures a screenshot using the snapsht CLI tool, uploads it to DropBox and posts the image url as a comment on the pull request.\n\n## Configuration\nCurrently, this action takes a single required input:\n\nurl: The URL to capture a screenshot of.\nThe GITHUB_TOKEN environment variable is also required and should be set to ${{ secrets.GITHUB_TOKEN }} to use the default token provided by GitHub Actions.\nThe DROPBOX_TOKEN is stored as a repository secret.\n\n## Contributing\nContributions to this project are welcome! Please feel free to open issues or submit pull requests with bug fixes, improvements, or new features.\n\n## License\nThis project is licensed under the MIT License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraiyanyahya%2Fscreenshot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fraiyanyahya%2Fscreenshot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraiyanyahya%2Fscreenshot/lists"}