wallswitch 0.13.1

randomly sets wallpapers for n Linux desktop monitors (arranged horizontally).
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157

# wallswitch

```
#-----------#-----------# ... ... #-----------#
|           |           |         |           |
| Monitor 1 | Monitor 2 |         | Monitor n |
|           |           |         |           |
#-----------#-----------# ... ... #-----------#
```
Randomly sets wallpapers for `n` Linux desktop monitors (arranged horizontally).

[Define papéis de parede aleatoriamente para desktop Linux com `n` monitores (dispostos horizontalmente).]

Run the command:
```
wallswitch
```

The default number of monitors is `n` = 2.

Images are recursively searched in the indicated directories (`"dirs": [...]`) for files with a jpg, jpeg or png extension.

## Help messages

To get help messages, run the command:

```
wallswitch -h
```

The output:
```
randomly sets wallpapers for n Linux desktop monitors (arranged horizontally).

Usage: wallswitch [OPTIONS]

Options:
  -c, --config
          Read the configuration file and exit the program
  -d, --dimension <DIMENSION>
          Set the minimum dimension that the height and width must satisfy
  -i, --interval <INTERVAL>
          Set the interval (in seconds) between each wallpaper displayed
  -n, --monitor_number <MONITOR_NUMBER>
          Set the number of monitors [default: 2]
  -s, --sort
          Sort the images found
  -v, --verbose
          Show intermediate runtime messages
  -h, --help
          Print help (see more with '--help')
  -V, --version
          Print version
```

## Configuration

Edit the configuration file: "/home/user_name/.config/wallswitch/wallswitch.json"

The contents of the configuration file can be displayed with the command:
```
wallswitch -c
```
or

```
cat ~/.config/wallswitch/wallswitch.json | jq
```

The output:
```
{
  "desktop": "gnome-xorg",
  "dirs": [
    "/home/user_name/Figures",
    "/home/user_name/Images",
    "/home/user_name/Pictures",
    "/home/user_name/Wallpapers",
    "/home/user_name/Imagens",
    "/usr/share/wallpapers",
    "/usr/share/backgrounds",
    "/tmp/teste"
  ],
  "extensions": [
    "jpg",
    "jpeg",
    "png"
  ],
  "interval": 1800,
  "min_dimension": 800,
  "wallpaper": "/home/user_name/wallswitch.jpg"
}
```

The default configuration file.

Add or remove directory paths that contain image files.

The interval between wallpapers is given in seconds.

## Desktops

Make changes to the source code.

```
git clone https://github.com/claudiofsr/wallswitch.git

cd wallswitch
```

Edit the file: 'src/desktops.rs'.

To build and install from source, run the following command:

```
cargo b -r && cargo install --path=.
```

Options:

### gnome

Create a wallpaper file and set it as your desktop background image.

See the function:
```
fn set_gnome_wallpaper()
```

### xfce

See the function:

```
fn set_xfce_wallpaper()
```

Monitor 1: "/backdrop/screen0/monitorDP-0/workspace0/last-image"

Monitor 2: "/backdrop/screen0/monitorDP-2/workspace0/last-image"

Monitor N: ...

### openbox

See the function:

```
fn set_openbox_wallpaper()
```

## Dependencies

1. [imagemagick](https://imagemagick.org/) (image viewing/manipulation program).

2. [feh](https://feh.finalrewind.org/) (fast and light image viewer).