{"id":16677878,"url":"https://github.com/yamafaktory/picst","last_synced_at":"2025-03-17T00:32:17.674Z","repository":{"id":62800856,"uuid":"562531567","full_name":"yamafaktory/picst","owner":"yamafaktory","description":"A cross-platform CLI tool to resize clipboard images on the fly","archived":false,"fork":false,"pushed_at":"2023-05-18T07:56:06.000Z","size":212,"stargazers_count":37,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-10-13T13:27:44.555Z","etag":null,"topics":["cli","clipboard","image","rust","rust-cli","tool","tools"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/yamafaktory.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-MIT","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-11-06T16:38:59.000Z","updated_at":"2024-05-25T09:08:44.000Z","dependencies_parsed_at":"2023-01-31T00:15:00.481Z","dependency_job_id":null,"html_url":"https://github.com/yamafaktory/picst","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yamafaktory%2Fpicst","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yamafaktory%2Fpicst/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yamafaktory%2Fpicst/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yamafaktory%2Fpicst/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yamafaktory","download_url":"https://codeload.github.com/yamafaktory/picst/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221669335,"owners_count":16860855,"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":["cli","clipboard","image","rust","rust-cli","tool","tools"],"created_at":"2024-10-12T13:27:47.050Z","updated_at":"2024-10-27T11:35:23.029Z","avatar_url":"https://github.com/yamafaktory.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"```\n██████╗ ██╗ ██████╗███████╗████████╗\n██╔══██╗██║██╔════╝██╔════╝╚══██╔══╝\n██████╔╝██║██║     ███████╗   ██║\n██╔═══╝ ██║██║     ╚════██║   ██║\n██║     ██║╚██████╗███████║   ██║\n╚═╝     ╚═╝ ╚═════╝╚══════╝   ╚═╝\n```\n\n[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/yamafaktory/picst/ci.yml?branch=main\u0026logo=github\u0026style=flat-square)](https://github.com/yamafaktory/picst/actions/workflows/ci.yml) [![Crates.io](https://img.shields.io/crates/v/picst?style=flat-square)](https://crates.io/crates/picst)\n\n## 📷 Presentation\n\n`picst` is a small cross-platform CLI tool aiming at making the \"copy → resize → paste\" image workflow super simple and more friendly.\n\nStart `picst`, copy an image, eventually provide new dimensions if not passed via the flags, paste it anywhere - a piece of cake 🍰!\n\n## 🛠️ Installation\n\n### Cargo\n\n```sh\ncargo install picst\n```\n\n### Binaries\n\nBinaries for new releases are also available [here](https://github.com/yamafaktory/picst/releases).\n\n## ⚡️ Usage\n\n`picst` is able to manage three different kind of unit to resize images: `percent` | `pixels` | `ratio`.\n\nNote: `picst` will keep running and checking for new images copied in the clipboard until the process is stopped.\n\n### Percent\n\nUse the `--height-percent` or the `--width-percent` flags:\n\n```sh\npicst --height-percent 30\n```\n\n```sh\npicst --width-percent 50\n```\n\nBy default, `picst` preserves the aspect ratio of the image and will adjust the other dimension accordingly.\n\nYou can either skip this behavior with the `--ignore-aspect-ratio` flag - the tool will then prompt you for the other dimension - or you can directly set both flags:\n\n```sh\npicst --height-percent 30 --width-percent 50\n```\n\n### Pixels\n\nUse the `--height` or the `--width` flags:\n\n```sh\npicst --height 300\n```\n\n```sh\npicst --width 500\n```\n\nBy default, `picst` preserves the aspect ratio of the image and will adjust the other dimension accordingly.\n\nYou can either skip this behavior with the `--ignore-aspect-ratio` flag - the tool will then prompt you for the other dimension - or you can directly set both flags:\n\n```sh\npicst --height 300 --width 500\n```\n\n### Ratio\n\nUse the `--ratio` flag:\n\n```sh\npicst --ratio 0.7\n```\n\n### Special case: no flags\n\nIf no flags are passed to the tool, a complete wizard will be presented to you:\n\n```sh\npicst\n```\n\n```sh\nPixel --------┐\n              |---\u003e  Height* | Width* | Both ---\u003e  value(s)\nPercentage ---┘\n\nRatio ------------\u003e  value\n```\n\n- With **Height** and **Width**, the aspect ratio will be preserved.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyamafaktory%2Fpicst","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyamafaktory%2Fpicst","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyamafaktory%2Fpicst/lists"}