Skip to content

Commit 152702c

Browse files
committed
Add doc
1 parent 21a9f31 commit 152702c

File tree

2 files changed

+68
-0
lines changed

2 files changed

+68
-0
lines changed

Diff for: README.md

+68
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
# Weighted Wallpaper Changer
2+
3+
Version 1.0 \
4+
Platform: Windows
5+
6+
## Description
7+
8+
Imagine that you have folder with wallpaper images, e.g.
9+
* Mountain 1.jpg
10+
* Mountain 2.jpg
11+
* Mountain 3.jpg
12+
* Mountain 4.jpg
13+
* Mountain 5.jpg
14+
* Ocean 1.jpg
15+
* Ocean 2.jpg
16+
17+
If you use standard system slideshow with random image selection,
18+
you will see much more mountain images than the ocean images because
19+
each image has the same probability. That means that there is
20+
`5/7 = 71 %` probability of showing mountain image and only `2/7 = 29 %`
21+
probability of showing the ocean.
22+
23+
*Weighted Wallpaper Changer* will use the first word in image name
24+
as a name of a group (category). When there is time to change the image
25+
it will first select the category and then an image from the category.
26+
So each group of images has the same probability. It means that in the
27+
given example, there is `50/50` probability of showing either mountain
28+
or the ocean image.
29+
30+
## Screenshot
31+
32+
![screenshot](Screenshot.png)
33+
34+
## Running
35+
36+
The app runs minimized in the tray. Also the minimize and close button
37+
actually minimizes the app into the tray.
38+
39+
Double click on the tray icon to open GUI where you can select folder
40+
with images.
41+
42+
Right click on the tray icon to open popup many where you can completely
43+
close the application (possible also from the GUI).
44+
45+
## Exact rules
46+
47+
Only file names ending with `.jpg` or `.jpeg` (case insensitive) are
48+
considered.
49+
50+
Name of a group consists of all characters from the filename from the
51+
beginning to either first whitespace (space, tab etc.) or the dot (.).
52+
53+
`Mountain 1.jpg` ==> group is `Mountain` \
54+
`Mountain1.jpg` ==> group is `Mountain1` !
55+
56+
So don't forget the put e.g. space after group.
57+
58+
It is OK for a group to have a single image.
59+
60+
Names of groups are case sensitive, i.e. `Mountain` and `mountain` are
61+
different group.
62+
63+
## Limititations
64+
65+
Only for Windows.
66+
67+
The interval for changing the images is hardcoded to 1 minute :)
68+

Diff for: Screenshot.png

14 KB
Loading

0 commit comments

Comments
 (0)