---

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