Skip to content
This repository was archived by the owner on Oct 23, 2022. It is now read-only.

Commit 58cc1b3

Browse files
authored
Update README.md
1 parent f1f1d82 commit 58cc1b3

File tree

1 file changed

+16
-17
lines changed

1 file changed

+16
-17
lines changed

README.md

Lines changed: 16 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -3,21 +3,21 @@ A simple app that lets you pin windows, videos and webpages to your desktop and
33

44
<img src="/img/1.png" width="250"> <img src="/img/2.png" width="250"> <img src="/img/3.png" width="250">
55

6-
## What does this do?
6+
### What does this do?
77
If you've ever looked into customising your desktop wallpaper further than what Windows allows, you may have come across a feature called "Active Desktop". It allowed you to use webpages and files as your wallpaper or overlay small windows on top of your desktop that stayed behind everything else. ADP attempts to reintroduce and supercharge this feature, allowing for any app, webpage or video you want to be kept on the desktop either as a full wallpaper or a small widget.
88

9-
## What apps can I use this with?
9+
### What apps can I use this with?
1010
This utility should work with most applications. It's generally not compatible with UWP apps or anything that draws its own titlebar though. Some good apps to try are browsers, video players such as Windows Media Player or VLC (if you need more control than the built-in video player), or terminal emulators such as Windows Terminal. Since fullscreen apps are drawn behind the taskbar, [TranslucentTB](https://github.com/TranslucentTB/TranslucentTB) works wonders to help improve the overall appearance.
1111

1212
# How do I use ADP?
1313
ADP's user interface is currently split into two sections; "Current apps" and "Saved apps". Both of these sections provide a key piece of functionality. Under "Current apps", you can view, manage and close any apps currently on the desktop, as well as send more to the desktop. From "Saved apps", you can add custom apps to a quick-launch list, giving them flags, exact positions and sizes, have them run on startup and even set videos as your wallpaper. Each button has a tooltip describing what they do, but for some basic actions see below.
1414

15-
## Sending an application to the desktop
15+
### Sending an application to the desktop
1616
0. With ADP open and the focused window, hold <kbd>Ctrl</kbd> and move the mouse cursor over the titlebar of the window you wish to send to the desktop.
1717
1. Release <kbd>Ctrl</kbd>, then click the "Send To Desktop" button.
1818
2. Press <kbd>Win</kbd>+<kbd>D</kbd> to go to the desktop, you should see the app on the desktop.
1919

20-
## Setting a video as your wallpaper
20+
### Setting a video as your wallpaper
2121
0. In ADP, click on the "Use Video" button.
2222
1. Type the path to the video in the box provided
2323
2. If you have multiple monitors, use the "Select Monitor" button to choose the monitor you wish to have the wallpaper on.
@@ -28,32 +28,31 @@ ADP's user interface is currently split into two sections; "Current apps" and "S
2828
# What properties can I change about an app?
2929
The following properties are all available to change for any app in the config file as well as directly from the UI.
3030

31-
## Command Line
31+
### Command Line
3232
The path to the application to be started. Can accept anything relying on the PATH variable.
33-
## Flags
33+
### Flags
3434
Any flags, arguments or switches you want to apply to the app at launch.
35-
## X & Y
35+
### X & Y
3636
Specifies the location the window should be placed, with `0, 0` being the top-left of your primary monitor. Note that Windows inverts the Y axis, so down the screen is more
37-
## Height & Width
37+
### Height & Width
3838
Specifies the new size of the window.
39-
## Friendly Name
39+
### Friendly Name
4040
What the application appears as in the Saved Apps list.
41-
## Wait Time
41+
### Wait Time
4242
How long ADP should wait for the application to have opened in milliseconds (default 1000). If this is is too low then the application's main window may open after ADP tries to send it to the desktop, so increase this if you have issues getting an app to work, or decrease this if you feel it stays open too long.
43-
## Start Locked
43+
### Start Locked
4444
Starts the application with interaction disabled.
45-
## Start with ADP
45+
### Start with ADP
4646
Starts the app at the same time ADP starts.
47-
## Start pinned
47+
### Start pinned
4848
Starts ADP without borders, and "pinned" to the desktop.
49-
## Fix Alignment
49+
### Fix Alignment
5050
Attempts to fix the position of an app if it appears partially or fully off-screen (Only useful on some multi-monitor setups, see "Does it break easily?" below)
5151

52-
5352
When adding an app under the "Saved Apps" secion, the only required value is `Command Line`, everything else can be left as-is if not needed and it will be ignored. Some apps may simply not work when they're saved due to how they handle their main window. It's worth experimenting to see what does and doesn't work. The configuration file is located at `%appdata%/ActiveDesktopPlus/saved.json`.
5453

55-
## Does it break easily?
54+
### Does it break easily?
5655
I've tried to make it as stable as possible and have for the most-part succeeded. However, it was written by me using my terrible approach to problem-solving so there's a good chance it might just explode your PC. At the moment, you can use this to child any element of any window to the desktop, including text boxes, buttons, sections of the taskbar etc., all with varying degrees of hilarity. However this can occasionally cause the tool, Explorer or other apps to crash. Be careful, if you break something it's your own fault. Furthermore, it's worth noting you may run into issues with some fullscreen apps if you use a multi-monitor setup where primary monitor's top-left corner is not the top-left corner of the entire desktop area (press <kbd>PrtSc</kbd>, paste into an image editor, and if the top-left corner of your primary monitor isn't in the top-left corner of the image then this may apply to you). As such, the Fix Alignment options exist, but these may not work for all apps. I'm looking into ways around that.
5756

58-
## Why can't I do `x` with it?
57+
### Why can't I do `x` with it?
5958
Because I've not added that feature. Feel free to complain at me or add it yourself though. I cannot guarantee compatibility with versions of Windows older than 10 2004. Microsoft are weird and keep moving around the order that the desktop windows are in. If it doesn't work, file an issue or something.

0 commit comments

Comments
 (0)