---

FoxyProxies

A modern, cross-platform desktop GUI for Tor and proxy management, built with Neutralino.js, React, TypeScript, and Vite.

---

---

Table of Contents

• ✨ About FoxyProxies
• Features
• How it works
• Getting Started
• Configuration
• Project Structure
• Troubleshooting
• Contributing
• License

---

✨ About FoxyProxies

FoxyProxies is a lightweight, cross-platform desktop application to control Tor, manage proxies, and visualize connection status. Built with Neutralino.js, React, TypeScript, and Vite.

Sleek, fast, and multiplatform — without Electron.

---

Features

• Start, stop, and restart Tor service
• Real-time security indicator and logs
• Country selection for routing
• Modern UI with React + TailwindCSS
• Works on Windows, Linux, macOS
• Lightweight (Neutralino.js, no Electron)

---

How it works

User Action
   │
   ▼
[FoxyProxies React UI] ──► [Neutralino Backend] ──► [Tor Process / Proxy Scripts]
   │
   └─► [Live Status, Logs, Security Indicator]

1. User interacts with the React UI (start/stop Tor, select country, view logs).
2. Neutralino backend executes system commands/scripts (e.g., launches Tor, changes proxy settings).
3. Status and logs are streamed back to the UI in real time.

[!NOTE] FoxyProxies does not use Electron, making it much lighter and faster to launch.

[!WARNING] Make sure you trust the Tor binaries and scripts included in tor-expert-bundle/ before running them.

---

Getting Started

1. Install dependencies

pnpm install

2. Run in development

• Start the Vite dev server:

  pnpm run dev
  

• In another terminal, launch the Neutralino window:

  pnpm run neutralino:start
  

  The app loads from http://localhost:3000 by default in dev mode.

3. Build the app

pnpm run build
pnpm run neutralino:build

---

Configuration

• Edit neutralino.config.json to adjust window size, application ID, and other options.
• The url field should point to a local file (./index.html) for production.
• Neutralino binaries are in bin/.
• Tor files are in tor-expert-bundle/.

---

Project Structure

├── index.html
├── package.json
├── tsconfig.json
├── vite.config.ts
├── neutralino.config.json
├── src/
│   ├── main.tsx
│   ├── App.tsx
│   ├── components/
│   ├── hooks/
│   ├── libs/
│   ├── styles/
│   └── types/
├── public/
├── bin/
├── tor-expert-bundle/
└── README.md

---

Troubleshooting

Symptom	Likely cause	Solution
Neutralino does not start	Missing binary or wrong path	Check the bin/ folder and config
Tor does not start	Wrong path or permissions	Check tor-expert-bundle/ and permissions
UI does not display	Wrong URL or missing build	Check Vite build and Neutralino config

---

Contributing

Contributions are welcome! Open an issue or PR. Keep changes small and tested.

---

License

MIT