{"id":28916893,"url":"https://github.com/ruslanlap/powertoysrun-randomgen","last_synced_at":"2026-04-13T18:02:15.457Z","repository":{"id":300455137,"uuid":"1006234812","full_name":"ruslanlap/PowerToysRun-RandomGen","owner":"ruslanlap","description":"🎲 RandomGen for PowerToys Run Generate random data instantly with a single keystroke ","archived":false,"fork":false,"pushed_at":"2025-06-21T20:02:39.000Z","size":0,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-06-21T20:21:33.580Z","etag":null,"topics":["csharp","datagenerator","designtools","dotnet","fakedata","faker","plugin","powertoys","powertoys-run","powertoys-run-plugin","windows","windows-10","windows-11"],"latest_commit_sha":null,"homepage":"https://ruslanlap.github.io/ruslanlap_buymeacoffe/","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/ruslanlap.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}},"created_at":"2025-06-21T19:47:30.000Z","updated_at":"2025-06-21T20:02:00.000Z","dependencies_parsed_at":"2025-06-21T20:32:24.062Z","dependency_job_id":null,"html_url":"https://github.com/ruslanlap/PowerToysRun-RandomGen","commit_stats":null,"previous_names":["ruslanlap/powertoysrun-randomgen"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/ruslanlap/PowerToysRun-RandomGen","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruslanlap%2FPowerToysRun-RandomGen","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruslanlap%2FPowerToysRun-RandomGen/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruslanlap%2FPowerToysRun-RandomGen/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruslanlap%2FPowerToysRun-RandomGen/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ruslanlap","download_url":"https://codeload.github.com/ruslanlap/PowerToysRun-RandomGen/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruslanlap%2FPowerToysRun-RandomGen/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261212506,"owners_count":23125585,"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","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":["csharp","datagenerator","designtools","dotnet","fakedata","faker","plugin","powertoys","powertoys-run","powertoys-run-plugin","windows","windows-10","windows-11"],"created_at":"2025-06-22T00:09:08.973Z","updated_at":"2026-04-13T18:02:15.445Z","avatar_url":"https://github.com/ruslanlap.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"assets/randomgen.logo.png\" width=\"200\" alt=\"RandomGen Logo\" style=\"margin-bottom: 20px;\"\u003e\n  \u003ch1\u003e🎲 RandomGen for PowerToys Run  🎲\u003c/h1\u003e\n  \u003ch3\u003eGenerate random data instantly with a single keystroke. Cool features like smart PIN generation, secure password creation, and more.\u003c/h3\u003e\n\n  \u003c!-- Badges --\u003e\n  \u003cdiv style=\"margin: 20px 0;\"\u003e\n    \u003ca href=\"https://github.com/ruslanlap/PowerToysRun-RandomGen/releases/latest\"\u003e\n      \u003cimg src=\"https://img.shields.io/github/v/release/ruslanlap/PowerToysRun-RandomGen?style=for-the-badge\u0026label=Latest%20Version\" alt=\"Latest Release\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/ruslanlap/PowerToysRun-RandomGen/actions/workflows/build-and-release.yml\"\u003e\n      \u003cimg src=\"https://github.com/ruslanlap/PowerToysRun-RandomGen/actions/workflows/build-and-release.yml/badge.svg?style=for-the-badge\" alt=\"Build Status\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/ruslanlap/PowerToysRun-RandomGen/releases\"\u003e\n      \u003cimg src=\"https://img.shields.io/github/downloads/ruslanlap/PowerToysRun-RandomGen/total?style=for-the-badge\" alt=\"Total Downloads\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/ruslanlap/PowerToysRun-RandomGen/blob/master/LICENSE\"\u003e\n      \u003cimg src=\"https://img.shields.io/github/license/ruslanlap/PowerToysRun-RandomGen?style=for-the-badge\" alt=\"License\"\u003e\n    \u003c/a\u003e\n  \u003c/div\u003e\n\n  \u003cdiv\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Supported%20Data%20Types-14%2B-success?style=flat-square\" alt=\"Supported Data Types\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Platform-Windows%2010%2B-0078d7?style=flat-square\" alt=\"Windows 10+\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/.NET-9.0-512BD4?style=flat-square\" alt=\".NET 9.0\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Arch-x64%20%7C%20ARM64-0078d7?style=flat-square\" alt=\"x64 | ARM64\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Automated%20Builds-CI%2FCD-2088FF?style=flat-square\u0026logo=github-actions\" alt=\"Automated Builds\"\u003e\n    \u003cimg src=\"https://img.shields.io/maintenance/yes/2025?style=flat-square\" alt=\"Maintenance\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/C%23-.NET%209-512BD4?style=flat-square\" alt=\"C# .NET 9\"\u003e\n    \u003ca href=\"https://github.com/ruslanlap/PowerToysRun-RandomGen/stargazers\"\u003e\n      \u003cimg src=\"https://img.shields.io/github/stars/ruslanlap/PowerToysRun-RandomGen?style=flat-square\u0026color=yellow\" alt=\"GitHub stars\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/ruslanlap/PowerToysRun-RandomGen/issues\"\u003e\n      \u003cimg src=\"https://img.shields.io/github/issues/ruslanlap/PowerToysRun-RandomGen?style=flat-square\" alt=\"GitHub issues\"\u003e\n    \u003c/a\u003e\n    \u003cimg src=\"https://img.shields.io/github/last-commit/ruslanlap/PowerToysRun-RandomGen?style=flat-square\" alt=\"Last Commit\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/commit-activity/m/ruslanlap/PowerToysRun-RandomGen?style=flat-square\" alt=\"Commit Activity\"\u003e\n    \u003ca href=\"https://twitter.com/intent/tweet?text=Check%20out%20this%20awesome%20PowerToys%20Run%20Random%20Data%20Generator%20plugin!\u0026url=https://github.com/ruslanlap/PowerToysRun-RandomGen\"\u003e\n      \u003cimg src=\"https://img.shields.io/twitter/url?style=social\u0026url=https%3A%2F%2Fgithub.com%2Fruslanlap%2FPowerToysRun-RandomGen\" alt=\"Tweet\"\u003e\n    \u003c/a\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Awesome-Yes-orange\" alt=\"Awesome\"\u003e\n    \u003ca href=\"https://github.com/hlaueriksson/awesome-powertoys-run-plugins\"\u003e\n      \u003cimg src=\"https://awesome.re/mentioned-badge.svg\" alt=\"Mentioned in Awesome PowerToys Run Plugins\"\u003e \u003c/a\u003e\n  \u003c/div\u003e\n\n  \u003cdiv style=\"margin: 20px 0;\"\u003e\n    \u003ca href=\"https://github.com/ruslanlap/PowerToysRun-RandomGen/releases/latest/download/RandomGen-1.0.2-x64.zip\"\u003e\n      \u003cimg src=\"https://img.shields.io/badge/Download_x64-2088FF?style=for-the-badge\u0026logo=windows\u0026logoColor=white\u0026labelColor=24292f\" alt=\"Download x64 Version\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/ruslanlap/PowerToysRun-RandomGen/releases/latest/download/RandomGen-1.0.2-arm64.zip\"\u003e\n      \u003cimg src=\"https://img.shields.io/badge/Download_ARM64-2088FF?style=for-the-badge\u0026logo=windows\u0026logoColor=white\u0026labelColor=24292f\" alt=\"Download ARM64 Version\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/ruslanlap/PowerToysRun-RandomGen/releases\"\u003e\n      \u003cimg src=\"https://img.shields.io/badge/All_Releases-2088FF?style=for-the-badge\u0026logo=github\u0026logoColor=white\u0026labelColor=24292f\" alt=\"All Releases\"\u003e\n    \u003c/a\u003e\n  \u003c/div\u003e\n\u003c/div\u003e\n\n## 📊 Download Statistics\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/downloads/ruslanlap/PowerToysRun-RandomGen/total?style=for-the-badge\u0026label=Total%20Downloads\" alt=\"Total Downloads\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/downloads/ruslanlap/PowerToysRun-RandomGen/latest/total?style=for-the-badge\u0026label=Latest%20Release\" alt=\"Latest Release Downloads\"\u003e\n\u003c/div\u003e\n\n## 🎥 Demo\n\n\u003cdiv align=\"center\"\u003e\n  \u003c!-- Main Overview Demo --\u003e\n  \u003cdiv style=\"margin-bottom: 25px;\"\u003e\n    \u003cp\u003e\u003cstrong\u003eOverview of RandomGen commands\u003c/strong\u003e\u003c/p\u003e\n    \u003cimg src=\"assets/demo-randomgen.gif\" width=\"800\" alt=\"Main Demo showing various RandomGen commands\"\u003e\n  \u003c/div\u003e\n  \n  \u003c!-- Password and PIN demos --\u003e\n  \u003cdiv style=\"display: flex; justify-content: space-between; margin-bottom: 25px;\"\u003e\n    \u003cdiv style=\"width: 48%;\"\u003e\n      \u003cp\u003e\u003cstrong\u003eCommand: \u003ccode\u003erd password 16\u003c/code\u003e\u003c/strong\u003e\u003c/p\u003e\n      \u003cp\u003eGenerate a secure 16-character password\u003c/p\u003e\n      \u003cimg src=\"assets/demo-randomgen-password.gif\" width=\"800\" alt=\"Password Generation Demo\"\u003e\n    \u003c/div\u003e\n    \u003cdiv style=\"width: 48%;\"\u003e\n      \u003cp\u003e\u003cstrong\u003eCommands: \u003ccode\u003erd pin 6\u003c/code\u003e and \u003ccode\u003erd color\u003c/code\u003e\u003c/strong\u003e\u003c/p\u003e\n      \u003cp\u003eGenerate a 6-digit PIN and random hex color\u003c/p\u003e\n      \u003cimg src=\"assets/demo-randomgen-pin-color.gif\" width=\"800\" alt=\"PIN and Color Generation Demo\"\u003e\n    \u003c/div\u003e\n  \u003c/div\u003e\n  \n  \u003c!-- Address/Date and GUID demos --\u003e\n  \u003cdiv style=\"display: flex; justify-content: space-between; margin-bottom: 25px;\"\u003e\n    \u003cdiv style=\"width: 48%;\"\u003e\n      \u003cp\u003e\u003cstrong\u003eCommands: \u003ccode\u003erd address\u003c/code\u003e and \u003ccode\u003erd date\u003c/code\u003e\u003c/strong\u003e\u003c/p\u003e\n      \u003cp\u003eGenerate a random address and date\u003c/p\u003e\n      \u003cimg src=\"assets/demo-randomgen-address-date.gif\" width=\"800\" alt=\"Address and Date Generation Demo\"\u003e\n    \u003c/div\u003e\n    \u003cdiv style=\"width: 48%;\"\u003e\n      \u003cp\u003e\u003cstrong\u003eCommand: \u003ccode\u003erd guid\u003c/code\u003e\u003c/strong\u003e\u003c/p\u003e\n      \u003cp\u003eGenerate a random GUID/UUID\u003c/p\u003e\n      \u003cimg src=\"assets/demo-randomgen-guid.gif\" width=\"800\" alt=\"GUID Generation Demo\"\u003e\n    \u003c/div\u003e\n  \u003c/div\u003e\n  \n  \u003c!-- Name and Number demos --\u003e\n  \u003cdiv style=\"display: flex; justify-content: space-between;\"\u003e\n    \u003cdiv style=\"width: 48%;\"\u003e\n      \u003cp\u003e\u003cstrong\u003eCommand: \u003ccode\u003erd name\u003c/code\u003e\u003c/strong\u003e\u003c/p\u003e\n      \u003cp\u003eGenerate a random person name\u003c/p\u003e\n      \u003cimg src=\"assets/demo-randomgen-name.gif\" width=\"800\" alt=\"Name Generation Demo\"\u003e\n    \u003c/div\u003e\n    \u003cdiv style=\"width: 48%;\"\u003e\n      \u003cp\u003e\u003cstrong\u003eCommand: \u003ccode\u003erd number 1-1000\u003c/code\u003e\u003c/strong\u003e\u003c/p\u003e\n      \u003cp\u003eGenerate a random number between 1 and 1000\u003c/p\u003e\n      \u003cimg src=\"assets/demo-randomgen-num.gif\" width=\"800\" alt=\"Number Generation Demo\"\u003e\n    \u003c/div\u003e\n  \u003c/div\u003e\n\u003c/div\u003e\n\n## 📋 Table of Contents\n\n- [✨ Features](#-features)\n- [🚀 Quick Start](#-quick-start)\n- [🔍 Usage](#-usage)\n- [⚙️ Installation](#️-installation)\n- [🧩 Requirements](#-requirements)\n- [🛠️ Building from Source](#️-building-from-source)\n- [🤝 Contributing](#-contributing)\n- [📄 License](#-license)\n- [🙏 Acknowledgements](#-acknowledgements)\n- [💬 Feedback and Support](#-feedback-and-support)\n- [❓ FAQ](#-faq)\n- [🔒 Security Note](#-security-note)\n\n## ✨ Features\n\nRandomGen is a powerful PowerToys Run plugin that generates various types of random data with a single keystroke. Perfect for developers, testers, and anyone who needs quick access to random data.\n\n### Key Features\n\n- 🔐 **Cryptographically Secure Passwords** - Generate strong passwords with mixed case, numbers, and symbols\n- 📍 **Secure PIN Codes** - Create numeric PINs with smart pattern detection to avoid weak PINs like 1234 or 0000\n- 👤 **Personal Data** - Generate realistic names, emails, phone numbers, and addresses\n- 🏢 **Business Data** - Company names and other business-related information\n- 📅 **Date Generation** - Random dates within customizable ranges\n- 🔢 **Number Generation** - Random numbers with custom min-max ranges\n- 🆔 **Unique Identifiers** - GUIDs/UUIDs for development and testing\n- 🎨 **Color Codes** - Random HEX colors for design and testing\n- 🌐 **Web Data** - URLs and domains for testing\n- 💳 **Payment Testing** - Credit card numbers (fake, for testing only)\n- 📝 **Lorem Ipsum** - Placeholder text with customizable word count\n\n### Technical Highlights\n\n- **Plugin ID:** `EFADBA167C1B41D8A7426A7DF808D28E`\n- **Action Keyword:** `rd`\n- **Thread-Safe Design** - Optimized for performance with thread-local Faker instances\n- **Smart Caching** - Improved performance with intelligent result caching\n- **Cryptographically Secure** - Uses `System.Security.Cryptography.RandomNumberGenerator` for secure random generation\n- **Intelligent Suggestions** - Smart autocomplete for commands\n- **Context Menu Support** - Right-click options for copying and regenerating values\n\n## 🚀 Quick Start\n\n1. **Download** the latest release for your architecture ([x64](https://github.com/ruslanlap/PowerToysRun-RandomGen/releases/download/v1.0.2/RandomGen-1.0.2-x64.zip) or [ARM64](https://github.com/ruslanlap/PowerToysRun-RandomGen/releases/download/v1.0.2/RandomGen-1.0.2-arm64.zip))\n2. **Extract** the ZIP file to your PowerToys Run plugins directory:\n   ```\n   %LOCALAPPDATA%\\Microsoft\\PowerToys\\PowerToys Run\\Plugins\\RandomGen\\\n   ```\n3. **Restart PowerToys**\n4. Press `Alt+Space` to open PowerToys Run\n5. Type `rd` followed by what you want to generate (e.g., `rd password`)\n6. Best practice: Press the Space button to regenerate a new value.\n\n## 📋 Changelog\n\n### v1.0.2 - Enhanced Password Generator Options\n![Password Generator Options](assets/demo-password-options.png)\n![Password Generator Options2](assets/demo-password-options2.png)\n1. **Enhanced Option Syntax Support**\n   - Now supports multiple ways to specify options:\n     - Exclusion: `-upper`, `-special`, `-numeric`, `-lower`\n     - Inclusion: `+upper`, `+special`, `+numeric`, `+lower`\n     - Natural language: `noupper`, `no-special`, `nonumbers`\n\n2. **Better Error Handling**\n   - Ensures at least one character type is always enabled\n   - Handles edge cases where all types are disabled\n   - Validates password length accommodates required character types\n\n3. **Improved Display**\n   - Better subtitle showing what's excluded: (16 chars, no upper,special)\n   - Clearer option descriptions in tooltips\n\n4. **Usage Examples**\n   - `rd password 16 -special` → 16-char password without symbols\n   - `rd password 22 -numeric` → 22-char password without numbers\n   - `rd pwd 12 -upper -special` → 12-char password with only lowercase + numbers\n   - `rd password 20 noupper` → 20-char password without uppercase letters\n\n## 🔍 Usage\n\n### Basic Commands\n\nUse the activation keyword `rd` followed by the data type you want to generate:\n\n| Command | Example | Description |\n|---------|---------|-------------|\n| `rd password [length]` | `rd password 16` | Generate a secure password (default: 12 chars) |\n| `rd pwd [length]` | `rd pwd 16` | Alias for password command |\n| `rd pin [length]` | `rd pin 6` | Generate a numeric PIN (default: 4 digits) |\n| `rd email` | `rd email` | Generate a random email address |\n| `rd name` | `rd name` | Generate a random full name |\n| `rd address` | `rd address` | Generate a random address |\n| `rd phone` | `rd phone` | Generate a random phone number |\n| `rd company` | `rd company` | Generate a random company name |\n| `rd lorem [count]` | `rd lorem 25` | Generate lorem ipsum text (default: 10 words) |\n| `rd number [min-max]` | `rd number 1-1000` | Generate a random number (default: 1-100) |\n| `rd num [min-max]` | `rd num 1-1000` | Alias for number command |\n| `rd date` | `rd date` | Generate a random date |\n| `rd guid` | `rd guid` | Generate a random GUID/UUID |\n| `rd uuid` | `rd uuid` | Alias for guid command |\n| `rd color` | `rd color` | Generate a random hex color |\n| `rd url` | `rd url` | Generate a random URL |\n| `rd creditcard` | `rd creditcard` | Generate a random credit card number (test use only) |\n| `rd credit` | `rd credit` | Alias for creditcard command |\n\n\n### Supported Locales\nBogus supports many locales. Use `rd locale \u003ccode\u003e` to change the language for generated data. Supported locale codes include:\n`af_ZA`, `ar`, `az`, `cz`, `de`, `de_AT`, `de_CH`, `el`, `en`, `en_AU`, `en_AU_ocker`, `en_BORK`, `en_CA`, `en_GB`, `en_IE`, `en_IND`, `en_NG`, `en_US`, `en_ZA`, `es`, `es_MX`, `fa`, `fi`, `fr`, `fr_CA`, `fr_CH`, `ge`, `hr`, `id_ID`, `it`, `ja`, `ko`, `lv`, `nb_NO`, `ne`, `nl`, `nl_BE`, `pl`, `pt_BR`, `pt_PT`, `ro`, `ru`, `sk`, `sv`, `tr`, `uk`, `vi`, `zh_CN`, `zh_TW`, `zu_ZA`.\n\n| `rd locale [code]` | `rd locale fr` | Change data generation locale |\n\n### Examples\n\n```bash\n# Generate a 16-character password\nrd password 16\n\n# Generate a 6-digit PIN\nrd pin 6\n\n# Generate a random email address\nrd email\n\n# Generate a random number between 1 and 1000\nrd number 1-1000\n\n# Generate 25 words of lorem ipsum text\nrd lorem 25\n\n\n# Change locale to French\nrd locale fr (or other `af_ZA`, `ar`, `az`, `cz`, `de`, `de_AT`, `de_CH`, `el`, `en`, `en_AU`, `en_AU_ocker`, `en_BORK`, `en_CA`, `en_GB`, `en_IE`, `en_IND`, `en_NG`, `en_US`, `en_ZA`, `es`, `es_MX`, `fa`, `fi`, `fr`, `fr_CA`, `fr_CH`, `ge`, `hr`, `id_ID`, `it`, `ja`, `ko`, `lv`, `nb_NO`, `ne`, `nl`, `nl_BE`, `pl`, `pt_BR`, `pt_PT`, `ro`, `ru`, `sk`, `sv`, `tr`, `uk`, `vi`, `zh_CN`, `zh_TW`, `zu_ZA` )\n```\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cimg src=\"./assets/locale.png\" width=\"100%\" alt=\"Locale Selection - Setting locale\"/\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cimg src=\"./assets/locale2.png\" width=\"100%\" alt=\"Locale Selection - UK locale\"/\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cimg src=\"./assets/locale3.png\" width=\"100%\" alt=\"Locale Selection - FR locale\"/\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n## ☕ Support\nEnjoying RandomGen? ☕ Buy me a coffee to support development:\n\n[![Buy me a coffee](https://img.shields.io/badge/Buy%20me%20a%20coffee-☕️-FFDD00?style=for-the-badge\u0026logo=buy-me-a-coffee\u0026labelColor=000000\u0026logoColor=white\u0026labelWidth=100\u0026logoWidth=100)](https://ruslanlap.github.io/ruslanlap_buymeacoffe/)\n\n### Advanced Features\n\n- **Context Menu** - Right-click on any result to:\n  - Copy to clipboard (Ctrl+C)\n  - Generate a new value (F5)\n\n- **Smart Autocomplete** - Type part of a command to see suggestions\n\n- **Intelligent Caching** - Recently generated values are cached for improved performance\n\n## ⚙️ Installation\n\n### Prerequisites\n- [PowerToys](https://github.com/microsoft/PowerToys) (v0.75 or later)\n- Windows 10/11 (x64 or ARM64)\n- .NET 9.0 Runtime (included with PowerToys)\n- Approximately 2MB of disk space\n\n### Installation Steps\n\n#### Method 1: Using the Release Package\n1. Download the latest release for your architecture ([x64](https://github.com/ruslanlap/PowerToysRun-RandomGen/releases/download/v1.0.2/RandomGen-1.0.2-x64.zip) or [ARM64](https://github.com/ruslanlap/PowerToysRun-RandomGen/releases/download/v1.0.2/RandomGen-1.0.2-arm64.zip))\n2. Extract the ZIP file to your PowerToys Run plugins directory:\n   ```\n   %LOCALAPPDATA%\\Microsoft\\PowerToys\\PowerToys Run\\Plugins\\RandomGen\\\n   ```\n3. Restart PowerToys\n4. Enable the plugin in PowerToys Settings → PowerToys Run → Plugin Manager\n\n#### Method 2: Manual Installation from Build\n1. Build the project (see [Building from Source](#️-building-from-source))\n2. Copy all files from the `RandomGen\\Publish\\` folder to your PowerToys Run plugins directory:\n   ```\n   %LOCALAPPDATA%\\Microsoft\\PowerToys\\PowerToys Run\\Plugins\\RandomGen\\\n   ```\n3. Restart PowerToys\n4. Enable the plugin in PowerToys Settings → PowerToys Run → Plugin Manager\n\n### Verifying Installation\nAfter installation, press `Alt+Space` to open PowerToys Run, then type `rd` to see if the plugin is working correctly.\n\n## 🧩 Requirements\n\n- Windows 10/11 (x64 or ARM64)\n- PowerToys v0.75 or later\n- .NET 9.0 Runtime (included with PowerToys)\n- Approximately 2MB of disk space\n\n## 🛠️ Building from Source\n\n### PTRUN Compliance\n\nThis plugin is fully compliant with PowerToys Run validation requirements:\n\n- ✅ **PTRUN1301**: Package naming follows the `\u003cname\u003e-\u003cversion\u003e-\u003cplatform\u003e.zip` convention\n- ✅ **PTRUN1303**: SHA256 checksums are generated for all packages\n- ✅ **PTRUN1401**: Plugin version in metadata matches filename version\n- ✅ **PTRUN1402**: No unnecessary PowerToys dependencies included\n\nThe GitHub Actions workflow automatically ensures compliance with these requirements.\n\n### Prerequisites\n- [.NET 9.0 SDK](https://dotnet.microsoft.com/download/dotnet/9.0)\n- [PowerToys](https://github.com/microsoft/PowerToys) (for testing)\n- [Visual Studio 2022](https://visualstudio.microsoft.com/) or [Visual Studio Code](https://code.visualstudio.com/)\n- [Git](https://git-scm.com/)\n\n### Build Steps\n\n```bash\n# Clone the repository\ngit clone https://github.com/ruslanlap/RandomGen.git\ncd RandomGen\n\n# Restore dependencies\ndotnet restore\n\n# Build the solution\ndotnet build -c Release\n\n# Create a publishable version (optional)\ndotnet publish -c Release -o ./Publish\n```\n\nThe built plugin will be in `RandomGen\\bin\\Release\\net9.0-windows10.0.22621.0` or in the `Publish` directory if you ran the publish command.\n\n### Project Structure\n\n- `RandomGen/Community.PowerToys.Run.Plugin.RandomGen/` - Main plugin code\n  - `Main.cs` - Core plugin implementation\n  - `Images/` - Plugin icons\n  - `plugin.json` - Plugin metadata\n- `RandomGen/Community.PowerToys.Run.Plugin.RandomGen.UnitTests/` - Unit tests\n\n### Dependencies\n\n- [Bogus](https://github.com/bchavez/Bogus) v35.6.3 - For generating realistic fake data\n- [Community.PowerToys.Run.Plugin.Dependencies](https://www.nuget.org/packages/Community.PowerToys.Run.Plugin.Dependencies/) v0.91.0 - PowerToys Run plugin dependencies\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### Ideas for Contribution\n\n- **New Data Types** - Add more types of random data generation\n- **Localization** - Add support for more languages and region-specific data formats\n- **Settings UI** - Create a settings page for customizing default values\n- **Performance Optimizations** - Improve caching and thread safety\n- **Enhanced Validation** - Add more validation for generated data\n- **Unit Tests** - Expand test coverage\n- **Documentation** - Improve inline code documentation and user guides\n\n### Development Guidelines\n\n- Follow the existing code style and patterns\n- Ensure all new features have appropriate unit tests\n- Use thread-safe practices for all data generation\n- Document any new commands or features\n- Test on both x64 and ARM64 architectures if possible\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 💬 Feedback and Support\n\nIf you encounter any issues or have suggestions for improvement, please [open an issue](https://github.com/ruslanlap/PowerToysRun-RandomGen/issues) on GitHub.\n\n## ❓ FAQ\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eHow do I change the default action keyword?\u003c/b\u003e\u003c/summary\u003e\n\u003cp\u003eYou can change the action keyword in PowerToys Settings → PowerToys Run → Plugin Manager → RandomGen → Action Keyword.\u003c/p\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eAre the generated passwords secure?\u003c/b\u003e\u003c/summary\u003e\n\u003cp\u003eYes, passwords are generated using cryptographically secure random number generation methods from the .NET framework, ensuring high entropy and unpredictability.\u003c/p\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eCan I use this data in production?\u003c/b\u003e\u003c/summary\u003e\n\u003cp\u003eThe generated data is intended for testing, development, and demonstration purposes only. While passwords are cryptographically secure, other data like names, addresses, and credit card numbers are fictional.\u003c/p\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eDoes this plugin work offline?\u003c/b\u003e\u003c/summary\u003e\n\u003cp\u003eYes, RandomGen works completely offline and doesn't require an internet connection.\u003c/p\u003e\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eHow can I add a new data type?\u003c/b\u003e\u003c/summary\u003e\n\u003cp\u003eTo add a new data type, you would need to modify the Main.cs file, add a new generator method, and update the command handling logic. See the Contributing section for more details.\u003c/p\u003e\n\u003c/details\u003e\n\n## 🔒 Security Note\n\n- **Secure Password Generation** - Passwords are generated using `System.Security.Cryptography.RandomNumberGenerator` for cryptographically secure randomness\n- **PIN Security** - PINs are checked against common patterns (like 1234, 0000) to avoid weak PINs\n- **Fake Data Only** - All generated data (names, addresses, credit cards, etc.) is completely fictional and suitable for testing only\n- **Privacy** - No personal data is collected, stored, or transmitted by this plugin\n- **Local Processing** - All data generation happens locally on your machine\n\n\u003e ⚠️ **Note:** While passwords generated by this tool use cryptographically secure methods, always follow your organization's security policies for production passwords.\n\n## 🙏 Acknowledgements\n\n- [Bogus](https://github.com/bchavez/Bogus) - For generating realistic fake data\n- [Microsoft PowerToys](https://github.com/microsoft/PowerToys) - For the amazing PowerToys Run platform\n- [All Contributors](https://github.com/ruslanlap/PowerToysRun-RandomGen/graphs/contributors) - For their valuable contributions\n- Credit card numbers are fake and generated using standard test patterns\n- Do not use generated personal information for malicious purposes","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fruslanlap%2Fpowertoysrun-randomgen","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fruslanlap%2Fpowertoysrun-randomgen","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fruslanlap%2Fpowertoysrun-randomgen/lists"}