Zebratic 76decebe22 Fix Linux compatibility for permission elevation and HTTP Toolkit launching
- Show sudo instructions instead of auto-elevating on Linux
- Show manual launch instructions instead of auto-launching HTTP Toolkit on Linux
- Windows and macOS behavior unchanged
2025-11-12 19:01:34 +01:00
2025-10-23 20:31:50 +02:00
2025-10-23 20:31:50 +02:00
2025-10-23 20:31:50 +02:00
2025-10-23 20:31:50 +02:00
2025-10-23 20:31:50 +02:00
2025-10-23 20:31:50 +02:00
2025-10-23 20:32:45 +02:00

HTTP Toolkit Patcher

A minimal, cross-platform patcher for HTTP Toolkit that removes subscription requirements.

WindowsTerminal_BsiVsdyUoj

Why?

I don't feel like paying a monthly subscription for an HTTP proxy/interceptor. A lifetime license? Sure. But subscription-based for a dev tool? No thanks.

How It Works

The patcher intercepts HTTP Toolkit's authentication functions:

  • isPaidUser
  • isLoggedIn
  • userHasSubscription
  • userEmail
  • mightBePaidUser
  • isPastDueUser

By hooking these functions, we bypass the subscription checks entirely.

Can They Fix It?

Yes, but they most likely won't. Fixing this would require changing their entire codebase architecture. And if they do? I'll just update the patcher.

Installation

  1. Install dependencies:
npm install

Building

Build standalone executables for all platforms and architectures:

npm run build

This creates self-contained executables in the dist/ directory:

Windows:

  • httptoolkit-patcher-win-x64.exe (64-bit)

Linux:

  • httptoolkit-patcher-linux-x64 (x86_64/AMD64)
  • httptoolkit-patcher-linux-arm64 (ARM64/AArch64)

macOS:

  • httptoolkit-patcher-macos-x64 (Intel)
  • httptoolkit-patcher-macos-arm64 (Apple Silicon M Chip)

Note: These are standalone executables created with pkg that include Node.js runtime and all dependencies. No need to install Node.js separately!

Usage

From Source

Patch:

npm start

Unpatch:

npm run unpatch

Using Prebuilt Executables

Download the appropriate executable for your platform from Releases, then:

Windows:

httptoolkit-patcher-win-x64.exe

Linux/macOS:

chmod +x httptoolkit-patcher-linux-x64  # or your architecture
./httptoolkit-patcher-linux-x64

That's it. The patcher handles everything automatically.

Technical Details

  1. Finds HTTP Toolkit installation
  2. Kills running processes
  3. Requests elevation if needed
  4. Backs up app.asar
  5. Extracts and patches preload.js
  6. Repackages and launches

Troubleshooting

Permission errors? Run as admin/sudo or let the patcher request elevation.

Already patched? The patcher will ask if you want to repatch.

Want to restore? Run npm run unpatch to restore from backup.

Anything else? Open an issue on the GitHub repository.

GitHub Release Workflow

This project includes an automated GitHub Actions workflow that builds and releases the patcher for all platforms.

Creating a Release

  1. Create and push a version tag:
git tag v2.0.1
git push origin v2.0.1
  1. The GitHub Actions workflow will automatically:
    • Build for all platforms and architectures (Windows x64, Linux x64/ARM64, macOS Intel/Apple Silicon)
    • Create standalone native executables using pkg
    • Create a GitHub release with all binaries as downloadable artifacts

Manual Workflow Trigger

You can also manually trigger the release workflow from the GitHub Actions tab.

Disclaimer

This tool is provided as-is. Use at your own risk. For educational purposes only.

License

MIT License - see LICENSE file.

S
Description
No description provided
Readme MIT
117 KiB
Languages
JavaScript 100%