{"id":35518772,"url":"https://github.com/nstechbytes/yourpicker","last_synced_at":"2026-01-03T23:02:18.978Z","repository":{"id":282666431,"uuid":"949295514","full_name":"NSTechBytes/YourPicker","owner":"NSTechBytes","description":"YourPicker is a Rainmeter plugin that provides a custom color picker with a modern interface.","archived":false,"fork":false,"pushed_at":"2025-12-04T15:17:51.000Z","size":197,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-07T09:24:17.592Z","etag":null,"topics":["c-sharp","color-picker","color-scheme","dll","magnifier","plugin","rainmeter","rainmeter-skin","skin"],"latest_commit_sha":null,"homepage":"https://github.com/NSTechBytes/YourPicker","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NSTechBytes.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-03-16T05:43:41.000Z","updated_at":"2025-12-04T15:20:29.000Z","dependencies_parsed_at":null,"dependency_job_id":"74dde4a9-6362-4b01-b37e-2e89b44ba94e","html_url":"https://github.com/NSTechBytes/YourPicker","commit_stats":null,"previous_names":["nstechbytes/your_picker"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/NSTechBytes/YourPicker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NSTechBytes%2FYourPicker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NSTechBytes%2FYourPicker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NSTechBytes%2FYourPicker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NSTechBytes%2FYourPicker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NSTechBytes","download_url":"https://codeload.github.com/NSTechBytes/YourPicker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NSTechBytes%2FYourPicker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28195265,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2026-01-03T02:00:06.471Z","response_time":75,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["c-sharp","color-picker","color-scheme","dll","magnifier","plugin","rainmeter","rainmeter-skin","skin"],"created_at":"2026-01-03T23:02:06.443Z","updated_at":"2026-01-03T23:02:18.972Z","avatar_url":"https://github.com/NSTechBytes.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# YourPicker\n\n\u003cdiv align=\"center\"\u003e\n\n![YourPicker Banner](.github/preview/example-skin.png)\n\n[![Version](https://img.shields.io/badge/version-1.6.0-blue.svg)](https://github.com/nstechbytes/YourPicker)\n[![Rainmeter](https://img.shields.io/badge/Rainmeter-4.5+-brightgreen.svg)](https://www.rainmeter.net/)\n[![Platform](https://img.shields.io/badge/platform-Windows%205.1+-lightgrey.svg)](https://www.microsoft.com/windows)\n[![License](https://img.shields.io/badge/license-MIT-orange.svg)](LICENSE)\n[![.NET](https://img.shields.io/badge/.NET-Framework-512BD4.svg)](https://dotnet.microsoft.com/)\n\n**A modern, feature-rich color picker plugin for Rainmeter with dual-mode selection and dark theme support.**\n\n[Features](#-features) • [Installation](#-installation) • [Usage](#-usage) • [Documentation](#-documentation) • [License](#-license)\n\n\u003c/div\u003e\n\n---\n\n## 📋 Table of Contents\n\n- [Features](#-features)\n- [Preview](#-preview)\n- [Installation](#-installation)\n- [Usage](#-usage)\n- [Plugin Options](#-plugin-options)\n- [Bang Commands](#-bang-commands)\n- [Examples](#-examples)\n- [Building from Source](#-building-from-source)\n- [Contributing](#-contributing)\n- [License](#-license)\n- [Credits](#-credits)\n\n---\n\n## ✨ Features\n\n- 🎨 **Dual Color Picker Modes**\n  - **Color Selector Mode** (`-cp`): Full-featured color picker with HSV/RGB controls\n  - **Magnifier Mode** (`-mp`): Quick screen color picker with magnified preview\n\n- 🌓 **Dark Mode Support**\n  - Automatic theme switching based on configuration\n  - Modern, clean UI design for both light and dark themes\n\n- 🎯 **Advanced Color Controls**\n  - Interactive color wheel with hue/saturation selection\n  - Brightness and opacity sliders\n  - RGB sliders (Red, Green, Blue)\n  - HSV sliders (Hue, Saturation, Value)\n  - Real-time color preview\n\n- 📋 **Multiple Output Formats**\n  - HEX color codes (e.g., `#FF5733`)\n  - RGB values (e.g., `255,87,51`)\n  - One-click copy to clipboard\n\n- 🔍 **Screen Color Picker**\n  - DPI-aware magnifier for precise color selection\n  - Square magnifier with real-time preview\n  - Keyboard shortcuts (ESC to cancel)\n\n- 🪟 **Modern UI Design**\n  - Rounded corners and smooth animations\n  - Draggable window interface\n  - Double-buffered rendering for flicker-free experience\n\n---\n\n## 🖼️ Preview\n\n### Light Theme\n![Light Theme Preview](.github/preview/light.png)\n\n### Dark Theme\n![Dark Theme Preview](.github/preview/dark.png)\n\n### Example Skin\n![Example Skin](.github/preview/example-skin.png)\n\n---\n\n## 📦 Installation\n\n### Method 1: Using .rmskin Package (Recommended)\n\n1. Download the latest `YourPicker_v1.6.0.rmskin` from the [Releases](../../releases) page\n2. Double-click the `.rmskin` file\n3. Rainmeter will automatically install the plugin and example skin\n\n### Method 2: Manual Installation\n\n1. Download the plugin DLL files:\n   - For 64-bit Rainmeter: `YourPicker.dll` (x64)\n   - For 32-bit Rainmeter: `YourPicker.dll` (x32)\n\n2. Copy the appropriate DLL to your Rainmeter plugins folder:\n   ```\n   C:\\Users\\[YourUsername]\\Documents\\Rainmeter\\Plugins\\\n   ```\n\n3. Refresh Rainmeter or restart the application\n\n---\n\n## 🚀 Usage\n\n### Basic Setup\n\nAdd the YourPicker measure to your Rainmeter skin:\n\n```ini\n[MeasureYourPicker]\nMeasure=Plugin\nPlugin=YourPicker\nReturnValue=Hex\nDarkMode=0\nOnFinishAction=[!UpdateMeter *][!Redraw]\n```\n\n### Triggering the Color Picker\n\nUse bang commands to open the color picker:\n\n```ini\n[ColorPickerButton]\nMeter=String\nText=\"Pick Color\"\nLeftMouseUpAction=[!CommandMeasure MeasureYourPicker \"-cp\"]\n```\n\n### Getting the Selected Color\n\nRetrieve the color value using the measure:\n\n```ini\n[ColorDisplay]\nMeter=String\nMeasureName=MeasureYourPicker\nText=\"Selected Color: %1\"\n```\n\n---\n\n## ⚙️ Plugin Options\n\nConfigure the YourPicker measure with the following options:\n\n| Option | Type | Default | Description |\n|--------|------|---------|-------------|\n| `ReturnValue` | String | `Hex` | Output format for color values. Options: `Hex`, `RGB` |\n| `DarkMode` | Integer | `0` | Enable dark theme. `0` = Light mode, `1` = Dark mode |\n| `OnFinishAction` | String | *(empty)* | Bangs to execute after color selection is complete |\n\n### Option Details\n\n#### `ReturnValue`\nDetermines the format of the returned color value:\n- **`Hex`**: Returns color in hexadecimal format (e.g., `#FF5733`)\n- **`RGB`**: Returns color in RGB format (e.g., `255,87,51`)\n\n#### `DarkMode`\nControls the visual theme of the color picker interface:\n- **`0`**: Light theme with bright backgrounds\n- **`1`**: Dark theme with dark backgrounds (GitHub-inspired design)\n\n#### `OnFinishAction`\nExecutes custom Rainmeter bangs after a color is selected. Useful for:\n- Updating meters with the new color\n- Saving the color to variables\n- Triggering other actions in your skin\n\n**Example:**\n```ini\nOnFinishAction=[!SetVariable MyColor \"[MeasureYourPicker]\"][!UpdateMeter *][!Redraw]\n```\n\n---\n\n## 🎮 Bang Commands\n\nExecute these commands to control the color picker:\n\n| Bang Command | Description | Usage Example |\n|--------------|-------------|---------------|\n| `[!CommandMeasure MeasureYourPicker \"-cp\"]` | Opens the **Color Selector** mode with full color controls | `LeftMouseUpAction=[!CommandMeasure MeasureYourPicker \"-cp\"]` |\n| `[!CommandMeasure MeasureYourPicker \"-mp\"]` | Opens the **Magnifier** mode for quick screen color picking | `LeftMouseUpAction=[!CommandMeasure MeasureYourPicker \"-mp\"]` |\n\n### Bang Command Details\n\n#### Color Selector Mode (`-cp`)\nOpens a comprehensive color picker window featuring:\n- Interactive color wheel for hue/saturation selection\n- Brightness and opacity sliders\n- RGB and HSV manual input sliders\n- Real-time color preview\n- Copy buttons for HEX and RGB values\n- \"Pick from Screen\" button to switch to magnifier mode\n\n**Best for:** Precise color selection, creating color schemes, manual color adjustments\n\n#### Magnifier Mode (`-mp`)\nOpens a screen color picker with:\n- DPI-aware magnified preview\n- Real-time color tracking under cursor\n- Click to select color\n- ESC key to cancel\n\n**Best for:** Quick color sampling from screen, matching existing colors, rapid color selection\n\n---\n\n## 📚 Examples\n\n### Example 1: Basic Color Picker\n\n```ini\n[Rainmeter]\nUpdate=1000\n\n[Variables]\nSelectedColor=#FFFFFF\n\n[MeasureYourPicker]\nMeasure=Plugin\nPlugin=YourPicker\nReturnValue=Hex\nOnFinishAction=[!SetVariable SelectedColor \"[MeasureYourPicker]\"][!UpdateMeter ColorBox][!Redraw]\n\n[PickerButton]\nMeter=String\nX=10\nY=10\nFontSize=12\nFontColor=255,255,255,255\nSolidColor=0,0,0,255\nPadding=10,5,10,5\nText=\"Open Color Picker\"\nAntiAlias=1\nLeftMouseUpAction=[!CommandMeasure MeasureYourPicker \"-cp\"]\n\n[ColorBox]\nMeter=Shape\nX=10\nY=50\nShape=Rectangle 0,0,100,100,5 | Fill Color #SelectedColor# | StrokeWidth 2 | Stroke Color 0,0,0,255\n```\n\n### Example 2: Quick Screen Picker\n\n```ini\n[MeasureYourPicker]\nMeasure=Plugin\nPlugin=YourPicker\nReturnValue=RGB\nDarkMode=1\nOnFinishAction=[!Log \"Color picked: [MeasureYourPicker]\"][!UpdateMeter *][!Redraw]\n\n[MagnifierButton]\nMeter=String\nText=\"Pick from Screen\"\nLeftMouseUpAction=[!CommandMeasure MeasureYourPicker \"-mp\"]\n```\n\n### Example 3: Dark Mode with Color Display\n\n```ini\n[Variables]\nMyColor=#000000\nMyColorRGB=0,0,0\n\n[MeasureYourPicker]\nMeasure=Plugin\nPlugin=YourPicker\nReturnValue=Hex\nDarkMode=1\nOnFinishAction=[!SetVariable MyColor \"[MeasureYourPicker]\"][!UpdateMeter ColorText][!Redraw]\n\n[ColorPickerButton]\nMeter=String\nText=\"Choose Color (Dark Mode)\"\nLeftMouseUpAction=[!CommandMeasure MeasureYourPicker \"-cp\"]\n\n[ColorText]\nMeter=String\nY=30\nText=\"Selected: #MyColor#\"\nFontColor=#MyColor#\n```\n\n---\n\n## 🔧 Building from Source\n\n### Prerequisites\n\n- **Visual Studio 2019 or later** (with C# desktop development workload)\n- **.NET Framework 4.5 or later**\n- **Rainmeter SDK** (included in the `API` folder)\n- **PowerShell** (for build script)\n\n### Build Steps\n\n1. **Clone the repository:**\n   ```bash\n   git clone https://github.com/nstechbytes/YourPicker.git\n   cd YourPicker\n   ```\n\n2. **Open the solution:**\n   ```\n   YourPicker.sln\n   ```\n\n3. **Build using PowerShell script:**\n   ```powershell\n   .\\Build.ps1\n   ```\n   This will:\n   - Build both x32 and x64 versions\n   - Export DLL files\n   - Create the `.rmskin` package in the `dist` folder\n\n4. **Manual build (alternative):**\n   - Open `YourPicker.sln` in Visual Studio\n   - Select configuration: `Release | x64` or `Release | x86`\n   - Build → Build Solution (Ctrl+Shift+B)\n   - DLL will be in `YourPicker\\x64\\Release\\` or `YourPicker\\x86\\Release\\`\n\n### Project Structure\n\n```\nYourPicker/\n├── .github/\n│   └── preview/          # Preview images\n│       ├── dark.png\n│       ├── light.png\n│       └── example-skin.png\n├── API/                  # Rainmeter API files\n│   ├── RainmeterAPI.cs\n│   └── DllExporter.exe\n├── Resources/            # Skin resources\n│   ├── Skins/\n│   │   └── YourPicker/\n│   │       └── Main.ini\n│   ├── skin_definition.json\n│   └── banner.bmp\n├── YourPicker/           # Plugin source code\n│   ├── Plugin.cs         # Main plugin entry point\n│   ├── YourPicker.cs     # Color picker forms\n│   ├── ModernSlider.cs   # Custom slider control\n│   ├── ColorUtils.cs     # Color conversion utilities\n│   ├── MagnifierForm.cs  # Magnifier window\n│   └── AssemblyInfo.cs\n├── Build.ps1             # Build automation script\n├── LICENSE\n└── README.md\n```\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! Here's how you can help:\n\n1. **Fork the repository**\n2. **Create a feature branch** (`git checkout -b feature/AmazingFeature`)\n3. **Commit your changes** (`git commit -m 'Add some AmazingFeature'`)\n4. **Push to the branch** (`git push origin feature/AmazingFeature`)\n5. **Open a Pull Request**\n\n### Development Guidelines\n\n- Follow C# coding conventions\n- Test on both x32 and x64 platforms\n- Update documentation for new features\n- Ensure backward compatibility with Rainmeter 4.5+\n\n---\n\n## 📄 License\n\nThis project is licensed under the **MIT License**.\nSee [LICENSE](LICENSE) file for full details.\n\n---\n\n## 👨‍💻 Credits\n\n**Developed by:** [NS Tech Bytes](https://github.com/nstechbytes) 🇵🇰\n\n**Built with:**\n- [Rainmeter](https://www.rainmeter.net/) - Desktop customization platform\n- C# / .NET Framework - Plugin development\n- Windows Forms - UI framework\n\n---\n\n## 🔗 Links\n\n- **GitHub Repository:** [YourPicker](https://github.com/nstechbytes/YourPicker)\n- **Issues \u0026 Bug Reports:** [GitHub Issues](https://github.com/nstechbytes/YourPicker/issues)\n- **Rainmeter Forum:** [Rainmeter Forums](https://forum.rainmeter.net/)\n- **Rainmeter Documentation:** [Rainmeter Docs](https://docs.rainmeter.net/)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**If you find this plugin useful, please consider giving it a ⭐ on GitHub!**\n\nMade with ❤️ by NS Tech Bytes\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnstechbytes%2Fyourpicker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnstechbytes%2Fyourpicker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnstechbytes%2Fyourpicker/lists"}