Skip to content

Commit

Permalink
docs: Improve configuration description
Browse files Browse the repository at this point in the history
  • Loading branch information
bcyran committed Dec 14, 2024
1 parent 54a8d58 commit 292c445
Showing 1 changed file with 16 additions and 10 deletions.
26 changes: 16 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,17 +46,10 @@ cargo install timewall
```

## Usage
### Initial configuration
If you intend to use sun position based wallpapers, you need to provide `timewall` with your approximate location.
To do this, create a config file `$XDG_CONFIG_HOME/timewall/config.toml` (probably `~/.config/timewall/config.toml` if you're not sure).
This file will be also written when you first run `timewall set`.

Put the following contents in the file, while changing `lat` (latitude) and `lon` (longitude) values to your needs:
```toml
[location]
lat = 51.11
lon = 17.02
```
### Initial configuration
If you intend to use sun position based wallpapers, you need to configure your geographical location.
See [Configuration](#geographical-location).

### Setting the wallpaper
#### One-time mode
Expand Down Expand Up @@ -128,6 +121,19 @@ timewall info path/to/wallpaper.heif
```

### Configuration
`timewall` uses a config file at `$XDG_CONFIG_HOME/timewall/config.toml` (usually `~/.config/timewall/config.toml`).
A default config will be written when you first run `timewall set`.

#### Geographical location
Using sun position based wallpapers requires your approximate geographical location.
This is configured as follows:
```toml
[location]
lat = 51.11
lon = 17.02
```
Adjust the values `lat` (latitude) and `lon` (longitude) to your needs.

#### Custom wallpaper setting command
If the default wallpaper setting doesn't work in your case for some reason, or you just want to customize it, you can specify custom command to use.
For instance, to set the wallpaper using `feh`, you could add the following to your `~/.config/timewall/config.toml`:
Expand Down

0 comments on commit 292c445

Please sign in to comment.