# Picto
Take bookmarks.json, a URL list (newline delimited), or a single URL - convert those to screenshots.
## Setup
```bash
python3 -mpip install picto
playwright install --with-deps chromium
```
## CLI
Save a URL as an image - optionally embed a HAR archive of the site.
**Usage**:
```console
$ picto [OPTIONS] COMMAND [ARGS]...
```
**Options**:
* `--install-completion`: Install completion for the current shell.
* `--show-completion`: Show completion for the current shell, to copy it or customize the installation.
* `--help`: Show this message and exit.
**Commands**:
* `snapshot`
### `snapshot`
**Usage**:
```console
$ picto snapshot [OPTIONS] COMMAND [ARGS]...
```
**Options**:
* `--help`: Show this message and exit.
**Commands**:
* `extract`: Take a picto snapshot and extract embedded...
* `take`: Take a snapshot of the provided URL -...
#### `snapshot extract`
Take a picto snapshot and extract embedded assets
**Usage**:
```console
$ picto snapshot extract [OPTIONS]
```
**Options**:
* `--filepath FILE`: The path to a picto snapshot [required]
* `--help`: Show this message and exit.
#### `snapshot take`
Take a snapshot of the provided URL -
optionally including a HAR file either as a standalone or
embedded in the returned image as EXIF data.
**Usage**:
```console
$ picto snapshot take [OPTIONS]
```
**Options**:
* `--filepath FILE`: The path to a bookmarks.json file as exported from a browser or a newline delimited text file of URLs
* `--url TEXT`: The URL of a website you wish to take a snapshot of
* `--out PATH`: The output directory to store results in [default: /tmp/picto]
* `--include-har / --no-include-har`: Capture and save a HAR file when taking the screenshot [default: no-include-har]
* `--include-pdf / --no-include-pdf`: Capture and save a PDF file when taking the screenshot [default: no-include-pdf]
* `--embed-har / --no-embed-har`: If true, enables include_har - save HAR in the screenshots EXIF data [default: no-embed-har]
* `--max-processes INTEGER`: The number of processes to spawn which will consume the bookmarks.json entries in parallel [default: 5]
* `--timeout FLOAT`: Wait at most this many seconds for a page to load [default: 15.0]
* `--no-progress / --no-no-progress`: Disable progress bar and just print the filepaths [default: no-no-progress]
* `--help`: Show this message and exit.
Raw data
{
"_id": null,
"home_page": "https://github.com/ArchiMoebius/picto",
"name": "picto",
"maintainer": "Archi Moebius",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "ArchiMoebius@dojobebo.com",
"keywords": "python3",
"author": "Archi Moebius",
"author_email": "ArchiMoebius@dojobebo.com",
"download_url": "https://files.pythonhosted.org/packages/35/e0/8626d997b6b0c905778857b8e7de6cc3e7e838f5286dd383cb2fbd860205/picto-0.1.4.tar.gz",
"platform": "Linux",
"description": "# Picto\n\nTake bookmarks.json, a URL list (newline delimited), or a single URL - convert those to screenshots.\n\n## Setup\n\n```bash\npython3 -mpip install picto\nplaywright install --with-deps chromium\n```\n\n## CLI\n\nSave a URL as an image - optionally embed a HAR archive of the site.\n\n**Usage**:\n\n```console\n$ picto [OPTIONS] COMMAND [ARGS]...\n```\n\n**Options**:\n\n* `--install-completion`: Install completion for the current shell.\n* `--show-completion`: Show completion for the current shell, to copy it or customize the installation.\n* `--help`: Show this message and exit.\n\n**Commands**:\n\n* `snapshot`\n\n### `snapshot`\n\n**Usage**:\n\n```console\n$ picto snapshot [OPTIONS] COMMAND [ARGS]...\n```\n\n**Options**:\n\n* `--help`: Show this message and exit.\n\n**Commands**:\n\n* `extract`: Take a picto snapshot and extract embedded...\n* `take`: Take a snapshot of the provided URL -...\n\n#### `snapshot extract`\n\nTake a picto snapshot and extract embedded assets\n\n**Usage**:\n\n```console\n$ picto snapshot extract [OPTIONS]\n```\n\n**Options**:\n\n* `--filepath FILE`: The path to a picto snapshot [required]\n* `--help`: Show this message and exit.\n\n#### `snapshot take`\n\nTake a snapshot of the provided URL -\noptionally including a HAR file either as a standalone or\nembedded in the returned image as EXIF data.\n\n**Usage**:\n\n```console\n$ picto snapshot take [OPTIONS]\n```\n\n**Options**:\n\n* `--filepath FILE`: The path to a bookmarks.json file as exported from a browser or a newline delimited text file of URLs\n* `--url TEXT`: The URL of a website you wish to take a snapshot of\n* `--out PATH`: The output directory to store results in [default: /tmp/picto]\n* `--include-har / --no-include-har`: Capture and save a HAR file when taking the screenshot [default: no-include-har]\n* `--include-pdf / --no-include-pdf`: Capture and save a PDF file when taking the screenshot [default: no-include-pdf]\n* `--embed-har / --no-embed-har`: If true, enables include_har - save HAR in the screenshots EXIF data [default: no-embed-har]\n* `--max-processes INTEGER`: The number of processes to spawn which will consume the bookmarks.json entries in parallel [default: 5]\n* `--timeout FLOAT`: Wait at most this many seconds for a page to load [default: 15.0]\n* `--no-progress / --no-no-progress`: Disable progress bar and just print the filepaths [default: no-no-progress]\n* `--help`: Show this message and exit.\n",
"bugtrack_url": null,
"license": "GPL-3 LGPL-3",
"summary": "Take bookmarks.json, a URL list, or a single URL - convert those to screenshots",
"version": "0.1.4",
"project_urls": {
"Bugs": "https://github.com/ArchiMoebius/picto/issues",
"C.I.": "https://github.com/ArchiMoebius/picto/",
"Docs": "https://github.com/ArchiMoebius/picto/README.md",
"Download": "https://github.com/ArchiMoebius/picto",
"Homepage": "https://github.com/ArchiMoebius/picto"
},
"split_keywords": [
"python3"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e78851baab580c9848070978aaa2c1570e858d000f4fd14977694c27d42198d1",
"md5": "5be6a2bb96b0dc3178ae9d51b8aa9ac6",
"sha256": "8402ea8ddc9c613e1fdaac80ca6493d9e9abe486cf920e040ba34d0db24160b0"
},
"downloads": -1,
"filename": "picto-0.1.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5be6a2bb96b0dc3178ae9d51b8aa9ac6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 20429,
"upload_time": "2023-11-18T17:46:15",
"upload_time_iso_8601": "2023-11-18T17:46:15.810688Z",
"url": "https://files.pythonhosted.org/packages/e7/88/51baab580c9848070978aaa2c1570e858d000f4fd14977694c27d42198d1/picto-0.1.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "35e08626d997b6b0c905778857b8e7de6cc3e7e838f5286dd383cb2fbd860205",
"md5": "8fcbe7dfef34e300ad4302616181fad1",
"sha256": "11104a4304032aeffe68346251cb85c9845e592b4664ef421599e032eac5ff19"
},
"downloads": -1,
"filename": "picto-0.1.4.tar.gz",
"has_sig": false,
"md5_digest": "8fcbe7dfef34e300ad4302616181fad1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 20055,
"upload_time": "2023-11-18T17:46:17",
"upload_time_iso_8601": "2023-11-18T17:46:17.533666Z",
"url": "https://files.pythonhosted.org/packages/35/e0/8626d997b6b0c905778857b8e7de6cc3e7e838f5286dd383cb2fbd860205/picto-0.1.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-11-18 17:46:17",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ArchiMoebius",
"github_project": "picto",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "picto"
}