https://github.com/nstechbytes/activeskin
ActiveSkin is a Rainmeter plugin that checks the Active status of a specified skin section in the Rainmeter.ini file. It returns whether the skin section is active (1) or inactive (0), allowing integration of this status into your Rainmeter skins.
https://github.com/nstechbytes/activeskin
activeskin c-sharp dll plugin rainmeter rainmeter-plugin rainmeter-skin skin
Last synced: 7 months ago
JSON representation
ActiveSkin is a Rainmeter plugin that checks the Active status of a specified skin section in the Rainmeter.ini file. It returns whether the skin section is active (1) or inactive (0), allowing integration of this status into your Rainmeter skins.
- Host: GitHub
- URL: https://github.com/nstechbytes/activeskin
- Owner: NSTechBytes
- License: apache-2.0
- Created: 2024-11-14T05:56:21.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-24T09:19:50.000Z (about 1 year ago)
- Last Synced: 2025-07-27T08:46:18.841Z (11 months ago)
- Topics: activeskin, c-sharp, dll, plugin, rainmeter, rainmeter-plugin, rainmeter-skin, skin
- Language: C#
- Homepage: https://nstechbytes.github.io/Nasir-Shahbaz/
- Size: 43.9 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ActiveSkin - Rainmeter Plugin
**ActiveSkin** is a **Rainmeter** plugin that checks the **Active** status of a specified skin section in the `Rainmeter.ini` file. It returns whether the skin section is **active** (`1`) or **inactive** (`0`), allowing integration of this status into your Rainmeter skins.
## Features
- **Checks the Active status** of a skin section from the `Rainmeter.ini` file.
- Returns `1` if the skin section is **active**, and `0` if it is **inactive**.
- Easy integration into Rainmeter skins using a simple measure.
## Installation
1. **Download the latest release** of **ActiveSkin** from the [Releases page](https://github.com/NSTechBytes/ActiveSkin/releases).
2. **Install the plugin** by copying `ActiveSkin.dll` into the Rainmeter `Plugins` directory:
- The default path is:
`C:\Users\\Documents\Rainmeter\Plugins\`
3. After installation, you can use the plugin in your Rainmeter skins.
## Usage
### 1. Create a Measure in your Rainmeter skin
In your `.ini` skin file, define a measure that uses the **ActiveSkin** plugin. Specify the section you want to check in the `SkinSection` parameter.
```ini
[Rainmeter]
Update=1000
BackgroundMode=2
SolidColor=ffffff
[mSkinActiveStatus]
Measure=Plugin
Plugin=ActiveSkin
SkinSection=illustro\System
IfCondition=(mSkinActiveStatus = 1)
IfTrueAction=[!Log "illustro\System is Active" "Debug"]
IfFalseAction=[!Log "illustro\System is Inactive" "Debug"]
DynamicVariables=1
[mSkinActiveStatus1]
Measure=Plugin
Plugin=ActiveSkin
SkinSection=illustro\Clock
IfCondition=(mSkinActiveStatus1 = 1)
IfTrueAction=[!Log "illustro\Clock is Active" "Debug"]
IfFalseAction=[!Log "illustro\Clock is Inactive" "Debug"]
DynamicVariables=1
[TextDisplay]
Meter=STRING
MeasureName=mSkinActiveStatus
X=10
Y=10
FontColor=000000
Text="illustro\System Status: %1"
FontSize=12
DynamicVariables=1
Antialias=1
[TextDisplay1]
Meter=STRING
MeasureName=mSkinActiveStatus1
X=10
Y=30
FontColor=000000
Text="illustro\Clock Status: %1"
FontSize=12
DynamicVariables=1
Antialias=1
[Measure1]
Meter=STRING
X=10
Y=50
FontColor=000000
Text=Measure1 Value : [mSkinActiveStatus]
FontSize=12
DynamicVariables=1
Antialias=1
[Measure2]
Meter=STRING
X=10
Y=70
FontColor=000000
Text=Measure2 Value : [mSkinActiveStatus1]
FontSize=12
DynamicVariables=1
Antialias=1
```
In this example:
- **SkinSection=MySkinSection** is the section in your `Rainmeter.ini` file whose **Active** status you want to check.
- `%1` will display `1` if the section is active, or `0` if it is inactive.
## Parameters
- **SkinSection**: The section name in the `Rainmeter.ini` file that you want to check. This parameter is required and should be specified in the `.ini` file for the skin to work correctly.
## Troubleshooting
- **Missing or Incorrect Section**: Ensure that the section name provided in the `SkinSection` parameter exactly matches the name in `Rainmeter.ini`.
- **File Not Found**: The plugin expects the `Rainmeter.ini` file to be located in the `AppData` folder (`%AppData%\Rainmeter\Rainmeter.ini`). Ensure this file exists.
## Contributing
If you'd like to contribute to this project, feel free to fork the repository and submit a pull request. Please follow the existing style and include tests where applicable.
### Bug Reports & Feature Requests
If you encounter bugs or want to suggest features, please use the [Issues tab](https://github.com/NSTechBytes/ActiveSkin/issues).
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.