{"id":47599870,"url":"https://github.com/charlyie/resmushit-cli","last_synced_at":"2026-04-01T18:42:20.398Z","repository":{"id":96856839,"uuid":"144483510","full_name":"charlyie/resmushit-cli","owner":"charlyie","description":"CLI client for reSmush.it : the Free Image Optimization API. Image optimizer shell script.","archived":false,"fork":false,"pushed_at":"2021-05-01T13:03:26.000Z","size":17,"stargazers_count":77,"open_issues_count":3,"forks_count":8,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-05-29T10:12:48.697Z","etag":null,"topics":["api-client","bash","image-processing","optimization","shell-script"],"latest_commit_sha":null,"homepage":"https://resmush.it","language":"Shell","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/charlyie.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2018-08-12T16:38:15.000Z","updated_at":"2025-04-22T20:04:07.000Z","dependencies_parsed_at":null,"dependency_job_id":"d06e53ca-5385-4940-87af-46082258ec30","html_url":"https://github.com/charlyie/resmushit-cli","commit_stats":{"total_commits":19,"total_committers":2,"mean_commits":9.5,"dds":0.1578947368421053,"last_synced_commit":"63c1fc2b80852e8b93ccfa97e3eca28ac632c07c"},"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/charlyie/resmushit-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/charlyie%2Fresmushit-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/charlyie%2Fresmushit-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/charlyie%2Fresmushit-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/charlyie%2Fresmushit-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/charlyie","download_url":"https://codeload.github.com/charlyie/resmushit-cli/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/charlyie%2Fresmushit-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31290944,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T13:12:26.723Z","status":"ssl_error","status_checked_at":"2026-04-01T13:12:25.102Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["api-client","bash","image-processing","optimization","shell-script"],"created_at":"2026-04-01T18:42:19.810Z","updated_at":"2026-04-01T18:42:20.385Z","avatar_url":"https://github.com/charlyie.png","language":"Shell","funding_links":["https://ko-fi.com/resmushit"],"categories":[],"sub_categories":[],"readme":"# reSmush.it Image Optimizer CLI client\n\nCLI client for the **reSmush.it Image Optimization API**\n\n\n## What is reSmush.it ?\n\nUse reSmush.it Image Optimizer for **FREE** to **optimize your pictures file sizes**. Improve your performances by using reSmush.it, the 10+ billion images API optimizer.\n\nreSmush.it Image Optimizer allows you to use **free Image optimization** based on [reSmush.it API](https://resmush.it/ \"Image Optimization API, developped by Charles Bourgeaux\"). reSmush.it provides image size reduction based on several advanced algorithms. The API accept JPG, PNG and GIF files up to **5MB**.\n\n\n## What is this tool ?\n\nThis tool allow you to perform a powerful optimization of one or multiple pictures using a bash (command line) script based on the reSmush.it API.\n\n\n## Getting Started\n\nThis tool can optimize one or several pictures. The recursive option is not yet implemented.\n\n1. Download the tool using this command `wget https://raw.githubusercontent.com/charlyie/resmushit-cli/master/install.sh | bash ./install.sh`\n2. Make the file `resmushit-cli.sh` executable using the following command : `chmod +x resmushit-cli.sh`\n3. Run the optimizer by typing command `./resmushit-cli.sh myfile.jpg`\n\n### Prerequisites\n\nThis will require to be executed on a Linux based Operating System (Linux or MacOS). The following packages must be installed on the system\n\n- `curl`\n- `jq` (*see [jq Homepage](https://stedolan.github.io/jq/ \"jq is a lightweight and flexible command-line JSON processor.\")*)\n\n### Install on your system\n\nIf you're using a Linux system (Debian, CentOS...) you can install after cloning from the GIT repo by typing the following command as `root` user (or using `sudo`) :\n\n- `mv resmushit-cli.sh /usr/bin/resmushit;chmod +x /usr/bin/resmushit`\n\nYour CLI optimizer will be available everywhere on your server/computer by typing `resmushit`\n\n### Usage example\n*Replace in the examples below `resmushit` by `./resmushit-cli.sh` if you haven't installed the optimizer globally on your machine.*\n\n**Optimize a picture and create a new optimized picture file**\n\n`resmushit mypicture.jpg`\n\n*The optimized file will be named `mypicture-optimized.jpg`* \n\n**Optimize a picture and replace the original file**\n\n`resmushit mypicture.jpg --preserve-filename`\n\n**Optimize a picture and set a optimization factor**\n\n`resmushit -q 92 mypicture.jpg`\n\n**Optimize multiple pictures and export them into a folder**\n\n`resmushit --output myexportdirectory/ *`\n\n**Optimize a folder recursively **\n\n`resmushit myfolder -r`\n`resmushit /path/to/folder -r`\n`resmushit * -r`\n\n**Optimize a picture and preserve its EXIF data**\n\n`resmushit mypicture.jpg --preserve-exif`\n\n\n### Options\n\n- `-h` or `--help` : display the help menu\n- `-v` or `--version` : display the current version of reSmushit CLI client\n- `-q \u003cquality\u003e` or `--quality \u003cquality\u003e` : specify the quality factor between 0 and 100 (default is 92).\n- `-o \u003cdirectory\u003e` or `--output \u003cdirectory\u003e` : specify an output directory (will be created if not present) \n- `-r` or `--recursive` : execute the optimization to the folder specified recusively\n- `--preserve-filename` : avoid to add `-optimized` in the filename when the image is optimized\n- `--preserve-exif` : will preserve EXIF data in the file after optimization\n- `--notime` : avoid to display timer in output\n- `--quiet` : run in quiet mode\n- `--update` : perform an auto-upgrade process\n\n\n## Bugs\n\nAll bugs should be reported to : [hello@resmush.it](mailto:hello@resmush.it) \n\n\n## Roadmap\n\n- [X] Add \"preserve filename\" option\n- [X] Add EXIF preservation option\n- [ ] Add progress bar mode\n- [X] Add support of recursive optimization\n- [X] Add an installer mode\n- [X] Add an auto-update method based on Git repo\n- [X] Avoid sending to API if file is \u003e 5MB\n\n\n## Versioning\n\nWe use [SemVer](http://semver.org/) for versioning. For the versions available, see the [tags on this repository](https://github.com/charlyie/resmushit-wordpress). \n\n\n## Authors\n\n* **Charles Bourgeaux** - *Initial work* - [reSmush.it](https://resmush.it)\n\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details\n\n\n## Support us on our new platform\nSupport us through Ko-Fi !\n\n[![Kofi](https://feed.resmush.it/images/kofi-button.png)](https://ko-fi.com/resmushit)\n\n\n## Changelog\n\n### v1.1.1 (build 20210501)\n\n- Avoid errors if SSL certificate is down\n- Add user agent in requests\n\n### v1.1.0 (build 20201115)\n\n- Add recursive mode for complete folder optimization\n\n### v1.0.9 (build 20200216)\n\n- Add an installer mode\n\n### v1.0.8 (build 20190122)\n\n- Fix an issue for filenames with spaces\n- Better check for the update temporary file writeability\n\n### v1.0.7 (build 20181222)\n\n- Better update check and upgrade minor fix\n\n### v1.0.6 (build 20181222)\n\n- Check if file is \u003e 5MB before sending it to the API\n\n### v1.0.5 (build 20180819)\n\n- Minor update bugfix\n\n### v1.0.4 (build 20180819)\n\n- Add an update verification\n- Add an auto-upgrade process\n\n### v1.0.3 (build 20180818)\n\n- Adding EXIF preservation support\n- Add a verification is file specified exists\n- Correction for the filename non-preservation by default\n\n\n### v1.0.2 (build 20180813)\n\n- Add a \"preserve-filename\" option\n- Preserve original filename when exporting in another directory\n\n\n### v1.0.1 (build 20180812)\n\n- Minor correction, unused variable, filename correction\n\n\n### v1.0.0 (build 20180812)\n\n- Initial version of the tool\n- Support 1 or multiple file optimization. \n- Avoid downloading picture if not optimized\n- No recursive mode implemented yet\n- Auto-exclude files which aren't supported\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcharlyie%2Fresmushit-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcharlyie%2Fresmushit-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcharlyie%2Fresmushit-cli/lists"}