Giter Club home page Giter Club logo

wallrus's Introduction

wallrus

Wallrus is a simple and blazing-fast wallpaper manager for linux.

It wraps around feh to provide a simple, fast, feature-rich and user-friendly experience.

Quick links:

Features

  • Fetching wallpapers online.
  • Supports multiple monitor.
  • Automatically change wallpapers using cron expressions (wallpaper slideshow).
  • Supports multiple modes [center, fill, scale, tile]
  • Saving fetched wallpapers to a file.
  • Aquiring currently applied wallpaper and saving it to a file.

Demo

demo

Usage

$ wallrus --help
wallrus x.x.x
TheHamkerCat <[email protected]>
A simple wallpaper manager for X11

USAGE:
    wallrus <SUBCOMMAND>

OPTIONS:
    -h, --help       Print help information
    -V, --version    Print version information

SUBCOMMANDS:
    help    Print this message or the help of the given subcommand(s)
    set     Set wallpaper by giving an image path or a query to search online.


$ wallrus set --help
Set wallpaper by giving an image path or a query to search online.

USAGE:
    wallrus set [OPTIONS]

OPTIONS:
    -c, --cron <cron>      Add current wallpaper command to crontab to change wallpaper
                           automatically. (Only works with --query)
    -h, --help             Print help information
    -m, --mode <mode>      The mode to set the wallpaper. [default: fill] [possible values: center,
                           fill, scale, tile]
    -p, --path <path>      Path to the wallpaper. Use $HOME instead of ~/
    -q, --query <query>    The query to search for. Pass `trending` for trending wallpapers
    -s, --save <save>      Save the newly fetched wallpaper in a new file. (Only works with --query)
    -x, --noxinerama       Disables Xinerama support, Making the wallpaper span across all monitors.

Examples

Set a local wallpaper

$ wallrus set --path=/path/to/wallpaper.jpg

Fetch & Set a wallpaper online

$ wallrus set --query=batman

Get trending ones instead

$ wallrus set --query=trending

Save wallpaper after setting

$ wallrus set --query=batman --save=a.png

Change wallpaper every hour

$ wallrus set --query=avengers --cron="0 * * * *"

Get current wallpaper and save it to a file

$ wallrus get --file=wall.png

Installation

$ git clone https://github.com/TheHamkerCat/wallrus
$ cd wallrus
$ bash ./install.sh

make sure .cargo/bin/ is in $PATH

wallrus's People

Contributors

axrav avatar thehamkercat avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.