{"id":24383346,"url":"https://github.com/firstandthird/stackshots","last_synced_at":"2025-06-10T12:06:09.015Z","repository":{"id":8936870,"uuid":"10669441","full_name":"firstandthird/stackshots","owner":"firstandthird","description":"Getting screenshots from BrowserStack Screenshot API from your CLI","archived":false,"fork":false,"pushed_at":"2017-04-29T19:40:21.000Z","size":21,"stargazers_count":10,"open_issues_count":7,"forks_count":4,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-05-10T07:48:14.304Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/firstandthird.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}},"created_at":"2013-06-13T15:36:44.000Z","updated_at":"2022-08-27T16:48:30.000Z","dependencies_parsed_at":"2022-08-27T11:50:24.659Z","dependency_job_id":null,"html_url":"https://github.com/firstandthird/stackshots","commit_stats":null,"previous_names":["belelros/node-browserscreenshot"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firstandthird%2Fstackshots","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firstandthird%2Fstackshots/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firstandthird%2Fstackshots/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firstandthird%2Fstackshots/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/firstandthird","download_url":"https://codeload.github.com/firstandthird/stackshots/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/firstandthird%2Fstackshots/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259072704,"owners_count":22801069,"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":"2025-01-19T10:14:18.130Z","updated_at":"2025-06-10T12:06:08.971Z","avatar_url":"https://github.com/firstandthird.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# stackshots\n\nstackshots uses the BrowserStack's Screenshot API to take screenshots from websites and downloads to your computer.\nIt's great for automated tests to get a glance of your site in different browsers.\n\nNote that this feature needs as of now, a \"Regular\" BrowserStack plan. Please, see [BrowserStack](http://www.browserstack.com/screenshots/pricing) for more details.\n\n## CLI Usage\n\nThese are the parameters of the CLI\n\n```\nOptions:\n  -u, --username     The email you use to log in to Browserstack                                                            [required]\n  -p, --password     Your account's password                                                                                [required]\n  -w, --website      The website(s) from which you want to get screenshots. Comma separated list\n  -b, --browser      The browser(s) from which you want to get screenshots. Comma separated list                            [default: \"IE_8,IE_9,Chrome,Firefox\"]\n  -o, --orientation  Orientation of the device (portrait|landscape).                                                        [default: \"portrait\"]\n  -s, --os           Operating System of the browser separating version with underscore (windows_xp). Comma separated list  [default: \"windows_7\"]\n  -d, --device       The device(s) from which you want to get screenshots. Comma separated list\n  -f, --folder       Folder in which screenshots will be stored                                                              [default: Current folder]\n  -l, --ls           Instead of getting images, it will output a list of browsers and OS available\n  -h, --help         Shows help info\n```\n\nYou may think that `website` should be mandatory. Since every single browser you request is a *paid* request and it will consume from the total, if you don't provide any website you only\nwill get the browsers to which you *would* submit the request. Try as many times as you want!\n\n### `username`\n\nThis is actually your email to log into your BrowserStack account\n\n### `password`\n\nPassword of your BrowserStack account\n\n### `website`\n\nComma separated list of the URL's you want to get screenshot's from.\n\nFor example:\n\n```\nwww.google.com,www.browserstack.com\n```\n\nOr just one:\n\n```\nwww.google.com\n```\n\n### `browser`\n\nBrowser from which you want to get an screenshot. By default they are:\n\n* Internet Explorer 8 \u0026 Internet Explorer 9\n* Chrome Latest\n* Firefox Latest\n\nIf you don't specify a version, it will suppose you wan't to get the latest one:\n\n```\n--browser ie\n```\n\nWill get you:\n\n* IE 10 Desktop - Windows 8\n* IE 10 normal - Windows 7\n\nYou can also get all of the versions from a browser, attaching `_all`:\n\n```\n--browser ie_all\n```\n\nOr a single version or a combination of them:\n\n```\n--browser ie_6,ie_7\n```\n\n* IE 6 - Windows XP\n* IE 7 - Windows XP\n\n#### Current available browsers\n\n* `safari`\n* `chrome`\n* `firefox`\n* `opera`\n* `ie`\n* `mobile safari`\n* `android browser`\n\nJust add `\"` if you need to add spaces:\n\n```\n--browser \"chrome,mobile safari_6.0\"\n```\n\n### `orientation`\n\nOrientation is usefull for Mobile Devices, otherwise, it is not. However, the program will not allow you to pass anything that's not `portrait` or `landscape`. By default is `portrait`.\n\n### `os`\n\nThis is the Operating System in which you can request Screenshots. By default is Windows\n\n```\n--os \"OS X\"\n```\n\nThe program is smart enough to know your intentions... some times. Let's say you want to get Firefox screenshots from Mac and screenshots from IE 8:\n\n```\n--os \"OS X\" --browser firefox,ie_8\n```\n\nWill get you:\n\n* Firefox 20 - Snow Leopard\n* Firefox 20 - Lion\n* Firefox 20 - Mountain Lion\n* IE 8 - Windows 7\n\nYou can specify the version with an underscore `_`:\n\n```\n--os \"OS X_Mountain Lion\" --browser firefox,ie_8\n```\n\n#### Currently available OS and versions\n\n| Operating System | Version       |\n| ---------------- |:-------------:|\n| **OS X**         | Snow Leopard  |\n| **OS X**         | Lion          |\n| **OS X**         | Mountain Lion |\n| **Windows**      | XP            |\n| **Windows**      | 8             |\n| **Windows**      | 7             |\n| **ios**          | 5.0           |\n| **ios**          | 5.1           |\n| **ios**          | 6.0           |\n| **android**      | 4.2           |\n| **android**      | 4.0           |\n| **android**      | 4.1           |\n| **android**      | 2.3           |\n| **android**      | 2.2           |\n\n### `device`\n\nThe device from which you want to take a screenshot.\n\n```\n--device \"iPhone 5\"\n```\n\n### Currently available devices in browsers and os versions\n\n| Browser | Device       | OS Version       |\n| ---------------- |:-------------:|:-------------:|\n| **Mobile Safari** | iPad 2 (5.0) | 5.0|\n| **Mobile Safari** | iPhone 4S | 5.1|\n| **Mobile Safari** | iPad 3rd | 5.1|\n| **Mobile Safari** | iPhone 4S (6.0) | 6.0|\n| **Mobile Safari** | iPhone 5 | 6.0|\n| **Mobile Safari** | iPad 3rd (6.0) | 6.0|\n| **Android Browser** | LG Nexus 4 | 4.2|\n| **Android Browser** | Samsung Galaxy Tab 2 10.1 | 4.0|\n| **Android Browser** | Samsung Galaxy Nexus | 4.0|\n| **Android Browser** | Motorola Atrix HD | 4.0|\n| **Android Browser** | Motorola Razr | 4.0|\n| **Android Browser** | HTC Evo 3D | 4.0|\n| **Android Browser** | HTC One X | 4.0|\n| **Android Browser** | Sony Xperia Tipo | 4.0|\n| **Android Browser** | Amazon Kindle Fire 2 | 4.0|\n| **Android Browser** | Amazon Kindle Fire HD 8.9 | 4.0|\n| **Android Browser** | Samsung Galaxy Note 10.1 | 4.0|\n| **Android Browser** | Samsung Galaxy S III | 4.1|\n| **Android Browser** | Samsung Galaxy Note II | 4.1|\n| **Android Browser** | Motorola Razr Maxx HD | 4.1|\n| **Android Browser** | Google Nexus 7 | 4.1|\n| **Android Browser** | Samsung Galaxy S II | 2.3|\n| **Android Browser** | Samsung Galaxy Note | 2.3|\n| **Android Browser** | Motorola Droid Razr | 2.3|\n| **Android Browser** | Motorola Droid 4 | 2.3|\n| **Android Browser** | Samsung Galaxy S | 2.2|\n| **Android Browser** | HTC Wildfire | 2.2|\n| **Android Browser** | LG Optimus 3D | 2.2|\n\n### `folder`\n\nThe folder in which you want to store the screenshots. By default is the folder in which you are invoking the process.\n\n```\n--folder /tmp\n```\n\n### `ls`\n\nThis option will ignore the rest of arguments and will output the list of browsers, versions and OS available so you have an idea of what is available.\n\n```\nBrowser: ie\nOS: windows\nVersions: 6.0, 7.0, 10.0 Desktop, 8.0, 9.0, 10.0\n```\n\n##Development and Tests\n\n```\nnpm install\n./node_modules/.bin/grunt\n```\n\n## Credits\n\nReally thanks for the support shown from [BrowserStack](http://www.browserstack.com/) guys, they made this possible.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffirstandthird%2Fstackshots","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffirstandthird%2Fstackshots","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffirstandthird%2Fstackshots/lists"}