Skip to content

Commit 4384041

Browse files
authored
Update README.md
1 parent 0b0ef35 commit 4384041

1 file changed

Lines changed: 90 additions & 2 deletions

File tree

README.md

Lines changed: 90 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,90 @@
1-
# MousePos
2-
The MousePos plugin is a simple yet powerful plugin for Rainmeter, designed to retrieve the current mouse position on your screen. You can display the mouse cursor's X or Y coordinates using this plugin.
1+
# MousePos - Rainmeter Plugin
2+
3+
The **MousePos** plugin is a simple yet powerful plugin for **Rainmeter**, designed to retrieve the current mouse position on your screen. You can display the mouse cursor's **X** or **Y** coordinates using this plugin.
4+
5+
## Features
6+
7+
- Retrieve the **X** and **Y** position of the mouse cursor.
8+
- Supports two types of measurements: **MouseX** and **MouseY**.
9+
- Easy to integrate with Rainmeter skins.
10+
- Written in C# using Rainmeter's plugin system.
11+
12+
## Installation
13+
14+
1. **Download the latest release** of **MousePos**.
15+
2. **Install the plugin** by copying `MousePos.dll` into your Rainmeter's `Plugins` folder:
16+
- Typically, the folder path is:
17+
`C:\Users\<YourUsername>\Documents\Rainmeter\Plugins\`
18+
3. After installation, you can use it in your Rainmeter skins.
19+
20+
## Usage
21+
22+
### 1. Add the plugin to your Rainmeter skin.
23+
24+
In your `.ini` skin file, define a measure that uses the **MousePos** plugin. You can specify whether you want the X or Y coordinate of the mouse.
25+
26+
```ini
27+
[Rainmeter]
28+
Update=50
29+
BackGroundMode=2
30+
SolidColor=ffffff
31+
32+
[MeasureMouseX]
33+
Measure=Plugin
34+
Plugin=MousePos
35+
MeasureType=MouseX
36+
DynamicVariables=1
37+
38+
[MeasureMouseY]
39+
Measure=Plugin
40+
Plugin=MousePos
41+
MeasureType=MouseY
42+
DynamicVariables=1
43+
44+
[MeterMouseX]
45+
Meter=STRING
46+
X=10
47+
Y=10
48+
FontColor=10,10,10
49+
Text=Mouse X: [MeasureMouseX]
50+
DynamicVariables=1
51+
Antialias=1
52+
53+
[MeterMouseY]
54+
Meter=STRING
55+
X=10
56+
Y=30
57+
FontColor=10,10,10
58+
Text=Mouse Y: [MeasureMouseY]
59+
DynamicVariables=1
60+
Antialias=1
61+
```
62+
63+
In this example:
64+
- **MeasureType=MouseX** will get the X position of the mouse.
65+
- **MeasureType=MouseY** will get the Y position of the mouse.
66+
67+
68+
69+
## Parameters
70+
71+
- **MeasureType**: Defines what measurement to fetch. Can be `MouseX` (for X coordinate) or `MouseY` (for Y coordinate).
72+
73+
## Troubleshooting
74+
75+
- Ensure the `MousePos.dll` file is correctly placed in the **Rainmeter Plugins** folder.
76+
- If you don't see the position, check the Rainmeter logs for any errors related to the plugin.
77+
78+
## Contributing
79+
80+
If you'd like to contribute to this project, you can:
81+
- Fork the repository.
82+
- Create a branch for your feature or fix.
83+
- Submit a pull request.
84+
85+
Please ensure that your code follows the existing style and includes necessary documentation or tests.
86+
87+
## License
88+
89+
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
90+

0 commit comments

Comments
 (0)