https://github.com/luckyturtledev/konachan-wallpaper

download and set desktop wallpaper from konachan.net
https://github.com/luckyturtledev/konachan-wallpaper

background desktop konachan rust wallpaper

Last synced: 5 months ago
JSON representation

download and set desktop wallpaper from konachan.net

• Host: GitHub
• URL: https://github.com/luckyturtledev/konachan-wallpaper
• Owner: LuckyTurtleDev
• License: apache-2.0
• Created: 2022-04-05T16:36:35.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2022-10-31T14:08:58.000Z (over 3 years ago)
• Last Synced: 2025-06-12T09:49:05.357Z (about 1 year ago)
• Topics: background, desktop, konachan, rust, wallpaper
• Language: Rust
• Homepage: https://crates.io/crates/konachan-wallpaper
• Size: 89.8 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# konachan-wallpaper

[![GitHub actions](https://github.com/LuckyTurtleDev/konachan-wallpaper/workflows/Rust/badge.svg)](https://github.com/LuckyTurtleDev/konachan-wallpaper/actions?query=workflow%3ARust)

[![crates.io](https://img.shields.io/crates/v/konachan-wallpaper.svg)](https://crates.io/crates/konachan-wallpaper)

[![License Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0)

[![konachan-wallpaper on deps.rs](https://deps.rs/repo/github/LuckyTurtleDev/konachan-wallpaper/status.svg)](https://deps.rs/repo/github/LuckyTurtleDev/konachan-wallpaper)

Program to download and set desktop wallpaper from [Konachan.net](https://konachan.net/).

The program download wallpapers to your local storage and can set them as wallpaper.

This allow you to set new wallpaper even if your pc is temporary offline.

## Commands:

* `konachan-wallpaper download`: download 200 wallpapers from konachan.net and save their path to a list (will override a existing list)

* `konachan-wallpaper set`: set background to a random wallpaper from the list

## Configuration:

You need to create a `config.txt` file.

This file should include tags separated by space.

Tags with does start with `-` will, be blacklisted.

Wildcard are not supported.

The file can be empty, at this case every image will be used.

You can add as many tags, as you want. The limitation of the website does not matter.

Example `config.txt`:

```txt

hatsune_miku headphones -underwear

```

The program support only [tags](https://konachan.net/tag?name=&type=&order=count) everything else like `rating:s` or `order:score` is not supported and leads to untested behavior.

Current the rating save is hard coded.

## Limitations: 

The program is current in a very early stage and many thing are not supported or are hardcoded at the moment.

Also the format of the config file will probably change multiple times.

Current the rating `save`, the picture count `200` and the order `latest` is hard coded.

For information about supported OS/desktop environments see the [more-wallpapers](https://crates.io/crates/more-wallpapers) crate.

## Installation:

Current are no prebuild binaries available. You must build konachan-wallpaper by yourself. See below.

### Building:

* Install [rust](https://www.rust-lang.org/tools/install).

* To build and install mstickereditor execute the following command:

```bash

cargo install --locked konachan-wallpaper

```

Check out [rust doc](https://doc.rust-lang.org/cargo/commands/cargo-install.html) for more information about `cargo install`.

* You can uninstall rust now.