{"id":22980822,"url":"https://github.com/thehamkercat/wallrus","last_synced_at":"2025-08-13T17:33:31.919Z","repository":{"id":59384865,"uuid":"535888826","full_name":"TheHamkerCat/wallrus","owner":"TheHamkerCat","description":"Wallrus is a simple wallpaper manager for linux.","archived":false,"fork":false,"pushed_at":"2022-10-01T07:22:59.000Z","size":4600,"stargazers_count":9,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"prod","last_synced_at":"2024-05-01T18:21:55.734Z","etag":null,"topics":["cli","cli-app","cli-utilities","feh","hacktoberfest","linux","rust","wallpaper","wallpaper-changer"],"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/TheHamkerCat.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-09-12T23:45:54.000Z","updated_at":"2023-10-24T13:42:55.000Z","dependencies_parsed_at":"2023-01-19T01:01:05.183Z","dependency_job_id":null,"html_url":"https://github.com/TheHamkerCat/wallrus","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/TheHamkerCat%2Fwallrus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheHamkerCat%2Fwallrus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheHamkerCat%2Fwallrus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheHamkerCat%2Fwallrus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TheHamkerCat","download_url":"https://codeload.github.com/TheHamkerCat/wallrus/tar.gz/refs/heads/prod","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":229773542,"owners_count":18122031,"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","cli-app","cli-utilities","feh","hacktoberfest","linux","rust","wallpaper","wallpaper-changer"],"created_at":"2024-12-15T01:45:05.708Z","updated_at":"2024-12-15T01:45:06.201Z","avatar_url":"https://github.com/TheHamkerCat.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# wallrus\n`Wallrus` is a simple and blazing-fast wallpaper manager for linux. \n\nIt wraps around [`feh`](https://github.com/derf/feh) to provide a simple, fast, feature-rich and user-friendly experience.\n\nQuick links:\n* [Features](#features)\n* [Demo](#demo)\n* [Usage](#usage)\n* [Examples](#examples)\n* [Installation](#installation)\n\n## Features\n\n- [x] Fetching wallpapers online.\n- [x] Supports multiple monitor.\n- [x] Automatically change wallpapers using [`cron`](https://crontab.guru/) expressions (wallpaper slideshow).\n- [x] Supports multiple modes [center, fill, scale, tile]\n- [x] Saving fetched wallpapers to a file.\n- [x] Aquiring currently applied wallpaper and saving it to a file.\n\n## Demo\n\n![demo](assets/demo.gif)\n\n## Usage\n\n```console\n$ wallrus --help\nwallrus x.x.x\nTheHamkerCat \u003cTheHamkerCat@gmail.com\u003e\nA simple wallpaper manager for X11\n\nUSAGE:\n    wallrus \u003cSUBCOMMAND\u003e\n\nOPTIONS:\n    -h, --help       Print help information\n    -V, --version    Print version information\n\nSUBCOMMANDS:\n    help    Print this message or the help of the given subcommand(s)\n    set     Set wallpaper by giving an image path or a query to search online.\n\n\n$ wallrus set --help\nSet wallpaper by giving an image path or a query to search online.\n\nUSAGE:\n    wallrus set [OPTIONS]\n\nOPTIONS:\n    -c, --cron \u003ccron\u003e      Add current wallpaper command to crontab to change wallpaper\n                           automatically. (Only works with --query)\n    -h, --help             Print help information\n    -m, --mode \u003cmode\u003e      The mode to set the wallpaper. [default: fill] [possible values: center,\n                           fill, scale, tile]\n    -p, --path \u003cpath\u003e      Path to the wallpaper. Use $HOME instead of ~/\n    -q, --query \u003cquery\u003e    The query to search for. Pass `trending` for trending wallpapers\n    -s, --save \u003csave\u003e      Save the newly fetched wallpaper in a new file. (Only works with --query)\n    -x, --noxinerama       Disables Xinerama support, Making the wallpaper span across all monitors.\n```\n\n## Examples\n### Set a local wallpaper\n\n```console\n$ wallrus set --path=/path/to/wallpaper.jpg\n```\n\n### Fetch \u0026 Set a wallpaper online\n\n```console\n$ wallrus set --query=batman\n```\n\n### Get trending ones instead\n\n```console\n$ wallrus set --query=trending\n```\n\n### Save wallpaper after setting\n\n```console\n$ wallrus set --query=batman --save=a.png\n```\n\n### Change wallpaper every hour\n\n```console\n$ wallrus set --query=avengers --cron=\"0 * * * *\"\n```\n\n### Get current wallpaper and save it to a file\n\n```console\n$ wallrus get --file=wall.png\n```\n\n## Installation\n\n```console\n$ git clone https://github.com/TheHamkerCat/wallrus\n$ cd wallrus\n$ bash ./install.sh\n```\nmake sure `.cargo/bin/` is in `$PATH`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthehamkercat%2Fwallrus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthehamkercat%2Fwallrus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthehamkercat%2Fwallrus/lists"}