{"id":16612899,"url":"https://github.com/ttys3/bismuth","last_synced_at":"2026-05-31T02:31:06.143Z","repository":{"id":225962294,"uuid":"719109260","full_name":"ttys3/Bismuth","owner":"ttys3","description":"A Rust cli util to set your desktop wallpaper to the newest 'Bing Image Of The Day'.","archived":false,"fork":false,"pushed_at":"2026-02-08T15:26:22.000Z","size":263,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-08T21:52:06.153Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","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/ttys3.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-11-15T13:26:31.000Z","updated_at":"2026-02-08T15:26:19.000Z","dependencies_parsed_at":"2024-06-03T16:59:18.710Z","dependency_job_id":"cee09308-fad7-4f25-b9d3-0540b63db283","html_url":"https://github.com/ttys3/Bismuth","commit_stats":null,"previous_names":["ttys3/bismuth"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/ttys3/Bismuth","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ttys3%2FBismuth","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ttys3%2FBismuth/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ttys3%2FBismuth/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ttys3%2FBismuth/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ttys3","download_url":"https://codeload.github.com/ttys3/Bismuth/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ttys3%2FBismuth/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33717415,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-31T02:00:06.040Z","response_time":95,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2024-10-12T01:45:16.542Z","updated_at":"2026-05-31T02:31:06.128Z","avatar_url":"https://github.com/ttys3.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bismuth\n\n\u003e [**Bismuth**](https://en.wikipedia.org/wiki/Bismuth) is a chemical element with the symbol **Bi** and atomic number 83.\n\n\u003e **ビスマス**（英語: bismuth `[ˈbɪzməθ]`）あるいは**蒼鉛**（そうえん）は、原子番号83の元素。元素記号は **Bi**（ラテン語: Bismuthumから）。第15族元素の一つ。\n\n![Bismuth](https://upload.wikimedia.org/wikipedia/commons/thumb/e/ef/Bismuth_crystals_and_1cm3_cube.jpg/500px-Bismuth_crystals_and_1cm3_cube.jpg)\n\n\n## Table of Contents\n\n- [About](#about)\n- [Dependencies](#dependencies)\n  - [Arch](#for-arch)\n  - [Debian, Ubuntu and Mint](#for-debian-ubuntu-and-mint)\n- [Installation](#installation)\n- [Usage](#usage)\n  - [Commands](#commands)\n  - [silent](#silent)\n  - [mode](#mode-mode)\n  - [custom command](#custom-command-custom_command)\n- [To-Do](#to-do)\n\n## About\nBismuth is a lightweight Rust script that sets your desktop wallpaper to the latest daily Bing image. \n\n## Dependencies\n\n|Dependency|Link                                              |\n|----------|--------------------------------------------------|\n|feh       |[Github](https://github.com/derf/feh)             |\n\n\n### For Fedora Linux\n\n```shell\ndnf install feh\n```\n\n### For Arch\n```\nparu -S feh\n```\n```\nyay -S feh\n```\n```\nsudo pacman -S feh\n```\n\n### For Debian, Ubuntu and Mint\n```\nsudo apt install feh\n```\n\n## Installation\n\n1\\. Clone the repository and cd into it.\n```\ngit clone \"https://github.com/ttys3/Bismuth\"\ncd Bismuth\n```\n2\\. Build Bismuth\n```\ncargo build --release\n```\n\n## Usage\nHere's an example usage of the script.\n```\nbismuth --silent --mode max\n```\n\n---\n\nOr you can also simply do;\n\nWhich calls `feh` using `--bg-fill` option as default.\n```\nbismuth\n```\n\n---\n\nHere's an example of a custom command, in this case using `swaybg`.\n\n`%` represents the file destination.\n```\nbismuth -c 'swaybg --image %'\n```\n\nThe wallpaper gets saved at `$HOME/.local/share/.wallpaper.jpg`.\n\n### Commands\n| Command                                     | Description                                                              |\n|---------------------------------------------|--------------------------------------------------------------------------|\n| `--silent`, `-s`                            | Disable notifications.                                                   |\n| `--mode`, `-m` `\u003cMODE\u003e`                     | Set feh scaling options.                                                 |\n| `--custom-command`, `-c` `\u003cCUSTOM_COMMAND\u003e` | Set background using custom command, this flag can repeat multiple times |\n| `--help`, `-h`                              | Display help information.                                                |\n| `--version`, `-V`                           | Show the version of the script.                                          |\n| `-b, --backup-dir \u003cBACKUP_DIR\u003e`             | Backup dir to copy daily wallpaper to                                    |\n| `--mkt \u003cMARKET\u003e`                            | Specify the market to use for the wallpaper                              |\n| `-r, --resolution \u003cRESOLUTION\u003e`             | Specify the resolution to use for the wallpaper.                         |\n\n### `--help`\n```\nUsage: bismuth [OPTIONS]\n\nOptions:\n  -s, --silent\n          Disables notifications\n  -m, --mode \u003cMODE\u003e\n          Specifies the scaling options for Feh [default: fill] [possible values: center, fill, max, scale, tile]\n  -c, --custom-command \u003cCUSTOM_COMMAND\u003e\n          Call custom wallpaper command, this flag can repeat multiple times\n  -b, --backup-dir \u003cBACKUP_DIR\u003e\n          Backup dir to copy daily wallpaper to\n      --mkt \u003cMARKET\u003e\n          Specify the market to use for the wallpaper. Available mkt: auto, ar-XA, da-DK, de-AT, de-CH, de-DE, en-AU, en-CA, en-GB, en-ID, en-IE, en-IN, en-MY, en-NZ, en-PH, en-SG, en-US, en-WW, en-XA, en-ZA, es-AR, es-CL, es-ES, es-MX, es-US, es-XL, et-EE, fi-FI, fr-BE, fr-CA, fr-CH, fr-FR, he-IL, hr-HR, hu-HU, it-IT, ja-JP, ko-KR, lt-LT, lv-LV, nb-NO, nl-BE, nl-NL, pl-PL, pt-BR, pt-PT, ro-RO, ru-RU, sk-SK, sl-SL, sv-SE, th-TH, tr-TR, uk-UA, zh-CN, zh-HK, zh-TW\n  -r, --resolution \u003cRESOLUTION\u003e\n          Specify the resolution to use for the wallpaper. Available resolution: auto UHD 1920x1200 1920x1080 1366x768 1280x720 1024x768 800x600\n  -h, --help\n          Print help (see more with '--help')\n  -V, --version\n          Print version\n```\n\n### `--silent`\nDisables notifications when the wallpaper is successfully set.\n\n### `--mode \u003cMODE\u003e`\n- `center`: Centers the image on the screen without scaling.\n- `fill`: Scales the image to fit the screen and preserves aspect ratio.\n- `max`: Scales the image to the maximum size with black borders on one side.\n- `scale`: Fills the screen, but doesn't preserve the aspect ratio.\n- `tile`: Tiles the image on the screen.\n\n### `--custom-command \u003cCUSTOM_COMMAND\u003e`\nSets wallpaper using a custom command.\n\nExample `bismuth -c \"swaybg --image %\"` \n\nThe `%` symbol is important as it signifies the file destination.\n\n### To-Do\n- [x] Save image as `.wallpaper.jpg` for `.fehbg`.\n- [x] Custom command support.\n\n### credits\n\nthis repo is originally forked from [thejayduck/Bismuth](https://github.com/thejayduck/Bismuth)\n\n### Related projects\n\n\nhttps://github.com/swsnr/picture-of-the-day\n\nhttps://flathub.org/apps/details/de.swsnr.pictureoftheday\n\n\u003e Get a picture of the day from any of the following sources as your daily wallpaper","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fttys3%2Fbismuth","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fttys3%2Fbismuth","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fttys3%2Fbismuth/lists"}