• About
• Dependencies
  • Arch
  • Debian, Ubuntu and Mint
• Installation
• Usage
  • Commands
  • silent
  • mode
  • custom command
• To-Do

Bismuth is a lightweight Rust script that sets your desktop wallpaper to the latest daily Bing image.

paru -S feh libnotify

yay -S feh libnotify

sudo pacman -S feh libnotify

sudo apt install feh libnotify-dev

1. Clone the repository and cd into it.

git clone "https://github.com/thejayduck/bismuth"
cd Bismuth

2. Build Bismuth

cargo build --release

Here's an example usage of the script.

bismuth --silent --mode max

Or you can also simply do;

Which calls feh using --bg-fill option as default.

bismuth

Here's an example of a custom command, in this case using swaybg.

% represents the file destination.

bismuth -c 'swaybg --image %'

The wallpaper gets saved in $HOME/.local/share/bismuth/.wallpaper.jpg.

Usage: bismuth [OPTIONS]
Options:
 -s, --silent
 Disables notifications
 -m, --mode <MODE>
 Specifies the scaling options for Feh [default: fill] [possible values: center, fill, max, scale, tile]
 -c, --custom-command <CUSTOM_COMMAND>
 Call custom wallpaper command
 -h, --help
 Print help (see more with '--help')
 -V, --version
 Print version

Disables notifications when the wallpaper is successfully set.

• center: Centers the image on the screen without scaling.
• fill: Scales the image to fit the screen and preserves aspect ratio.
• max: Scales the image to the maximum size with black borders on one side.
• scale: Fills the screen, but doesn't preserve the aspect ratio.
• tile: Tiles the image on the screen.

Sets wallpaper using a custom command.

Example bismuth -c "swaybg --image %"

The % symbol is important as it signifies the file destination.

The custom command gets saved in $HOME/.local/share/bismuth/config.txt.

• Save image as .wallpaper.jpg for .fehbg.
• Custom command support.
• Save custom command.