diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml index b6d10a0a..e76ae4aa 100644 --- a/.github/FUNDING.yml +++ b/.github/FUNDING.yml @@ -1,6 +1,6 @@ # These are supported funding model platforms -github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2] +github: gerardog patreon: # gerardog ko_fi: # Replace with a single Ko-fi username tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel @@ -9,4 +9,4 @@ liberapay: # Replace with a single Liberapay username issuehunt: # Replace with a single IssueHunt username otechie: # Replace with a single Otechie username lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry -custom: ['https://gerardog.github.io/gsudo/sponsor'] +custom: ['https://www.paypal.com/donate/?business=EGM43RDQ4VRWJ&no_recurring=0&item_name=%0APlease+help+me+dedicate+more+time+to+gsudo%21%0AIf+gsudo+has+improved+your+productivity%2C+please+contribute%21¤cy_code=USD'] diff --git a/README.md b/README.md index 9c85012d..d1379bc7 100644 --- a/README.md +++ b/README.md @@ -6,9 +6,9 @@ [![GitHub Downloads](https://img.shields.io/github/downloads/gerardog/gsudo/total?label=GitHub%20Downloads)](https://github.com/gerardog/gsudo/releases/latest) **gsudo** is a `sudo` equivalent for Windows, with a similar user-experience as the original Unix/Linux sudo. -Allows you to run a command with elevated permissions, or to elevate the current shell, in the current console window or a new one. - -Just [prepend `gsudo`](#usage) (or the `sudo` alias) to your command and it will run elevated. For PowerShell use `gsudo { ScriptBlock }` [syntax](#usage-from-powershell--powershell-core). +Allows you to run a command (or re-launch your current shell) with elevated permissions, in the current console window or a new one. + +Just [prepend `gsudo`](#usage) (or the `sudo` alias) to your command and it will run elevated. For PowerShell use this [syntax](#usage-from-powershell--powershell-core): `gsudo { ScriptBlock }` One UAC popup will appear each time. You can see less popups if you enable [gsudo cache](#credentials-cache). diff --git a/docs/docs/gsudo-vs-sudo.md b/docs/docs/gsudo-vs-sudo.md index c45aa4d9..6364c008 100644 --- a/docs/docs/gsudo-vs-sudo.md +++ b/docs/docs/gsudo-vs-sudo.md @@ -6,7 +6,7 @@ title: Comparison with Microsoft sudo # Comparison between gsudo and Microsoft sudo -`gsudo` was born in 2019 as a productivity tool and is open-source. It has been downloaded over 700k times so far and has enjoyed a warm reception from users. +`gsudo` was born in 2019 as a productivity tool and is open-source. It has been downloaded over 700k times so far and has enjoyed a warm reception from users. It is very easy to install and works from Windows 7 SP1 up to Windows 11. Microsoft initially declined to create a similar tool, citing security concerns. However `gsudo`'s documentation [challenged this view](security.md) arguing that absolute security is unattainable without altering Windows itself, and that the default same-desktop UAC is not completely secure either. @@ -21,8 +21,9 @@ Surprisingly, Microsoft's sudo does not leverage new OS features to enhance secu | ------- | ------- | ------------------ | | Executes command with elevated permissions | Yes | Yes | | Supports output redirection (`sudo dir > file.txt`) | Yes | Yes | -| Supports input redirection (`echo md folder \| sudo cmd`) | Yes | Partial (Only with output redirection) | -| Returns the command exit code | Yes | No | +| Supports input redirection (`echo md SomeFolder | sudo cmd`) | Yes | Requires v1.0.0 / Windows insider build 26080 | +| Returns the command exit code | Yes | Requires v1.0.0 / Windows insider build 26080 | +| Preserves the current directory | Yes | [It depends](https://github.com/microsoft/sudo/issues/63) | | Source code available | [Yes](https://github.com/gerardog/gsudo) | Not for `sudo.exe`, but [promised](https://github.com/microsoft/sudo/blob/f8f1d05/README.md#contributing) | ### Security Impersonation Features @@ -58,7 +59,7 @@ Surprisingly, Microsoft's sudo does not leverage new OS features to enhance secu | Feature | `gsudo` | Sudo for Windows | | ------- | ------- | ------------------ | -| Elevation syntax | `gsudo { Script } -args $a,$b` [syntax](usage/powershell.md#using-gsudo-scriptblock-syntax) | Unknown, possibly: `sudo pwsh { script }` | +| Elevation syntax | `gsudo { scriptblock } -args $a,$b` [syntax](usage/powershell.md#using-gsudo-scriptblock-syntax) | Unknown, possibly: `sudo pwsh { scriptblock } -args $a,$b` | | Auto-complete of last 3 commands | Yes (with [gsudoModule](usage/powershell.md#gsudo-powershell-module)) | No | | Auto-complete of options | Yes (with [gsudoModule](usage/powershell.md#gsudo-powershell-module)) | No | | Red # indicator for elevation | Yes (with [gsudoModule](usage/powershell.md#gsudo-powershell-module)) | No | diff --git a/docs/docusaurus.config.js b/docs/docusaurus.config.js index 4298e4cc..04342221 100644 --- a/docs/docusaurus.config.js +++ b/docs/docusaurus.config.js @@ -25,13 +25,13 @@ const config = { docs: { sidebarPath: require.resolve('./sidebars.js'), // Please change this to your repo. - editUrl: 'https://github.com/gerardog/gsudo/blob/docs/docs/', + editUrl: 'https://github.com/gerardog/gsudo/tree/master/docs/', }, blog: { showReadingTime: true, // Please change this to your repo. editUrl: - 'https://github.com/gerardog/gsudo/tree/master/docs/blog/', + 'https://github.com/gerardog/gsudo/tree/master/docs/', }, theme: { customCss: require.resolve('./src/css/custom.css'), diff --git a/docs/src/pages/sponsor.md b/docs/src/pages/sponsor.md index b0a94f99..b7b2ab43 100644 --- a/docs/src/pages/sponsor.md +++ b/docs/src/pages/sponsor.md @@ -5,16 +5,20 @@ title: Sponsor ## Sponsor gsudo -Please consider sponsoring my open source work, mainly on gsudo. I have dedicated my free time for months making this project. +Hi, I'm Gerardo, a seasoned software developer from Argentina with a journey in programming that began at the age of 15. My passion for technology led me to create 'gsudo', an open-source project that enhances the windows desktop. -It also helps support the costs of the yearly renewal for the code-signing certificate. +Through sponsorship, you can help sustain the ongoing development of 'gsudo', including keeping it updated, adding new features, and potentially kickstarting new projects. Your support will address practical needs like covering code-signing certificate costs and other expenses, enabling me to focus on innovation and development. -> To provide a signed application (and not let the UAC popup show "Untrusted Publisher", which also protects end users by helping them detect that gsudo binaries hadn´t been altered) I have paid 56 USD each year, since 2020, for an Open-Source Code-Signing certificate. The [last purchase](https://github.com/gerardog/gsudo/issues/82) expired in Apr 2022. Please consider sponsoring me to ensure I can provide signed binaries for another year. +`gsudo` is delivered as a signed application. This ensures the UAC popup doesn't show "Untrusted Publisher", and protects end users detect that gsudo binaries hadn´t been altered. -💵 BTC 33LVf9Ek9hg5dQYf1EFWUoJaF5W3tWrrhZ +On Nov 2022, [Parag Mehta @parag_c_mehta](https://twitter.com/gerardo_gr/status/1595817336405168134) gifted me a code signing certificate which expires in Nov 2025. We have some months left to collect $632 for another [3 year renewal](https://signmycode.com/code-signing-certificates). -💵 ETH/USDC/USDT/SHIB 0x3c207f47a80b6feede8e9546ea1ca68635652452 +How to donate: + +💵 [Via GitHub Sponsors](https://github.com/sponsors/gerardog) 💵 One time, or recurring donations via [PayPal or Debit/Credit Card](https://www.paypal.com/donate/?business=EGM43RDQ4VRWJ&no_recurring=0&item_name=%0APlease+help+me+dedicate+more+time+to+gsudo%21%0AIf+gsudo+has+improved+your+productivity%2C+please+contribute%21¤cy_code=USD) -I'm working on sponsoring platforms, so this page may be updated soon. Still the mentioned platforms work. \ No newline at end of file +💵 BTC 33LVf9Ek9hg5dQYf1EFWUoJaF5W3tWrrhZ + +💵 ETH/USDC/USDT/SHIB 0x3c207f47a80b6feede8e9546ea1ca68635652452 diff --git a/yarn.lock b/yarn.lock index 1d4a4f1b..35947b65 100644 --- a/yarn.lock +++ b/yarn.lock @@ -7630,9 +7630,9 @@ webpack-bundle-analyzer@^4.5.0: ws "^7.3.1" webpack-dev-middleware@^5.3.1: - version "5.3.3" - resolved "https://registry.yarnpkg.com/webpack-dev-middleware/-/webpack-dev-middleware-5.3.3.tgz#efae67c2793908e7311f1d9b06f2a08dcc97e51f" - integrity sha512-hj5CYrY0bZLB+eTO+x/j67Pkrquiy7kWepMHmUMoPsmcUaeEnQJqFzHJOyxgWlq746/wUuA64p9ta34Kyb01pA== + version "5.3.4" + resolved "https://registry.yarnpkg.com/webpack-dev-middleware/-/webpack-dev-middleware-5.3.4.tgz#eb7b39281cbce10e104eb2b8bf2b63fce49a3517" + integrity sha512-BVdTqhhs+0IfoeAf7EoH5WE+exCmqGerHfDM0IL096Px60Tq2Mn9MAbnaGUe6HiMa41KMCYF19gyzZmBcq/o4Q== dependencies: colorette "^2.0.10" memfs "^3.4.3"