{"id":50315951,"url":"https://github.com/r3li4nt/onionymous","last_synced_at":"2026-05-29T00:02:07.724Z","repository":{"id":352765633,"uuid":"1214725345","full_name":"R3LI4NT/Onionymous","owner":"R3LI4NT","description":"A modern, privacy-first desktop client for the Tor network. Un cliente de escritorio moderno para la red Tor, enfocado en privacidad.","archived":false,"fork":false,"pushed_at":"2026-05-17T14:56:03.000Z","size":46010,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-17T15:50:04.510Z","etag":null,"topics":["anonymity","hacking","pentesting","privacy","rust","security","tor","windows"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/R3LI4NT.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-19T00:50:39.000Z","updated_at":"2026-05-17T14:56:07.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/R3LI4NT/Onionymous","commit_stats":null,"previous_names":["r3li4nt/onionymous"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/R3LI4NT/Onionymous","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/R3LI4NT%2FOnionymous","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/R3LI4NT%2FOnionymous/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/R3LI4NT%2FOnionymous/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/R3LI4NT%2FOnionymous/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/R3LI4NT","download_url":"https://codeload.github.com/R3LI4NT/Onionymous/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/R3LI4NT%2FOnionymous/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33630999,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-28T02:00:06.440Z","response_time":99,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["anonymity","hacking","pentesting","privacy","rust","security","tor","windows"],"created_at":"2026-05-29T00:02:02.498Z","updated_at":"2026-05-29T00:02:07.713Z","avatar_url":"https://github.com/R3LI4NT.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg width=\"275\" height=\"260\" alt=\"Onionymous\" src=\"https://github.com/user-attachments/assets/6cab7c7d-9f99-4381-8671-832d3772747a\" /\u003e\n\u003c/p\u003e\n\n\n\u003cp align=\"center\"\u003e\n  \u003cem\u003eA modern, privacy-first desktop client for the Tor network.\u003c/em\u003e\u003cbr/\u003e\n  \u003cem\u003eUn cliente de escritorio moderno para la red Tor, enfocado en privacidad.\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e【 https://r3li4nt.github.io/tools/Onionymous 】\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.rust-lang.org/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Rust-1.78%2B-CE422B?style=for-the-badge\u0026logo=rust\u0026logoColor=white\" alt=\"Rust\" /\u003e\u003c/a\u003e\n  \u003ca href=\"#\"\u003e\u003cimg src=\"https://img.shields.io/badge/VERSION-1.1-8A5CFF?style=for-the-badge\u0026logoColor=white\" alt=\"Version\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.microsoft.com/windows/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Windows-10%20%2F%2011-0078D4?style=for-the-badge\u0026logo=windows\u0026logoColor=white\" alt=\"Windows\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.torproject.org/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Tor-Network-7D4698?style=for-the-badge\u0026logo=torproject\u0026logoColor=white\" alt=\"Tor\" /\u003e\u003c/a\u003e\n  \u003ca href=\"#-license\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-MIT-22C55E?style=for-the-badge\" alt=\"License\" /\u003e\u003c/a\u003e\n  \u003ca href=\"#-internationalization\"\u003e\u003cimg src=\"https://img.shields.io/badge/i18n-ES%20%2F%20EN-E11D2E?style=for-the-badge\" alt=\"i18n\" /\u003e\u003c/a\u003e\n  \u003ca href=\"#\"\u003e\u003cimg src=\"https://img.shields.io/badge/Portable-YES-FF6200?style=for-the-badge\" alt=\"Portable\" /\u003e\u003c/a\u003e\n  \u003ca href=\"#\"\u003e\u003cimg src=\"https://img.shields.io/github/downloads/R3LI4NT/Onionymous/total?style=for-the-badge\u0026color=8A5CFF\u0026label=Downloads\u0026logo=github\u0026logoColor=white\" alt=\"Downloads\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#english\"\u003eEnglish\u003c/a\u003e · \u003ca href=\"#español\"\u003eEspañol\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n\u003ca id=\"english\"\u003e\u003c/a\u003e\n\n## English\n\n### Overview\n\n**Onionymous** is a native Windows desktop application that routes your traffic through the Tor network with a modern, opinionated UI. The official Tor binary, geoip databases, and pluggable transports are all embedded inside a single portable `.exe` — no installer, no external folders, no hand-edited config files.\n\nIt is aimed at users who want the privacy and censorship-circumvention benefits of Tor without the complexity of running Tor manually or configuring a SOCKS proxy by hand. Onionymous manages the Tor process for you, watches the bootstrap in real time, rotates identities on demand, and shows connection state and bandwidth at a glance.\n\n\u003cimg width=\"1919\" height=\"1029\" alt=\"dashboard\" src=\"https://github.com/user-attachments/assets/d01d3c59-afea-475e-806c-6f5ee2718653\" /\u003e\n\n### 🆕 Features (v1.0)\n\n#### 🎯 Connection control\n- **Click-the-orb UX** — the central animated circle *is* the connect/disconnect button. No extra buttons cluttering the dashboard\n- **Live bootstrap progress** painted as a filled arc around the orb, tracking the Tor bootstrap percentage as it happens\n- **Visual feedback for every state** — power icon when off, spinner while connecting, shield-check when connected, warning on failure\n- **Pulsating glow** when connected, directional chirp sounds when toggling state\n- **Public IP display in amber** on the dashboard, updated on every connect and after each identity rotation\n- **Automatic cleanup** of stale `tor.exe` processes that would otherwise block the SOCKS port on restart\n\n#### 🌐 Routing \u0026 privacy\n- **Local SOCKS5 proxy** on `127.0.0.1:9050` — Tor-aware apps get routed automatically via system proxy settings\n- **Exit country selector** — choose from 40+ countries for your exit relay, or leave it on *Automatic*\n- **Excluded countries list** — permanently blacklist countries from being used as guard/middle/exit nodes\n- **Bridges / pluggable transports** for censored networks:\n  - **obfs4** — most common, fast, good for light censorship\n  - **Snowflake** — WebRTC-based, good for heavy censorship\n  - **Custom bridges** — paste your own lines from bridges.torproject.org\n- **New Identity** button — forces Tor to rebuild circuits and present a fresh IP\n- **Refresh IP** button — re-queries your public IP without rebuilding circuits\n\n#### 🛡️ Security\n- **Kill Switch** via Windows Defender Firewall — blocks all non-Tor traffic at the OS level (requires admin). Automatically torn down on disconnect so you're never left without internet\n- **Automatic admin detection** — the switch is offered but gracefully skipped if you're running as a normal user, with a clear log message instead of failing silently\n- **Cookie-authenticated control port** — no passwords on disk, Tor rotates the cookie on every launch\n\n#### 📊 Observability\n- **Real-time bandwidth sparkline** with violet download / amber upload, 60-sample rolling window, normalised to local peak\n- **Session totals** for bytes read and written\n- **Full event log** combining Tor and app events, filterable by source and level, with auto-scroll to the tail\n- **Circuit summary card** showing exit country and bridge status at a glance\n\n#### 🔧 Tools\n- **Update Tor** button — downloads the latest Tor Expert Bundle directly from the official Tor Project archive at `archive.torproject.org`, verifies its SHA-256 checksum against the signed `sha256sums-signed-build.txt` manifest, and installs the new binaries atomically\n- **Live terminal output** with timestamped, severity-colored lines while the update runs\n- **Installed version detection** with timestamp of last successful update, cached per session so it doesn't hammer `tor.exe` on every frame\n\n#### 🎨 User experience\n- **Custom violet theme** with DWM Mica / Acrylic blur on Windows 10 \u0026 11\n- **Animated circular status orb** as the focal UI element — painted from scratch with the egui painter API\n- **Phosphor Icons** throughout for consistent, sharp iconography that renders on any system regardless of installed fonts\n- **Synthesized UI sounds** — click, tick, connect chirp, disconnect chirp, error warble — all generated in memory by `rodio`, no audio files bundled\n- **Bilingual** — English and Spanish, switchable at runtime via the globe button in the header\n- **True portability** — the `.exe` extracts its embedded runtime to `%LocalAppData%\\Onionymous\\runtime\\\u003cversion\u003e\\` on first launch, then runs from that cache. Move the `.exe` anywhere and it still works\n\n#### 🖥️ System integration\n- **Start with Windows** via `HKCU\\...\\Run` (idempotent registry entry)\n- **Start minimized** when launched by autostart\n- **Optional minimize-to-tray** on close (off by default to avoid confusing first-time users)\n- **Clean shutdown** button — disconnects Tor, removes the proxy, tears down the kill switch, then exits\n\n\u003ch1 align=\"center\"\u003e\u003c/h1\u003e\n\n### 🆕 Features (v1.1)\n\n🌐 **TUN/VPN Mode (admin)**\n\n- **System-wide routing** through Tor — not just proxy-aware apps. Any program (even ones that ignore the system proxy) goes through the Tor network when this mode is active\n- **Implemented with Wintun** (WireGuard's official TUN driver) + sing-box as the TUN→SOCKS bridging engine, both embedded in the .exe\n- **Mode selector on the home screen:** Proxy or TUN/VPN — the user picks whichever fits the need\n- **Automatic admin detection** — if you pick TUN without admin rights, it warns you clearly; if tunnel creation fails for any reason, it automatically falls back to Proxy mode without breaking the connection\n- **Robust cleanup** — on disconnect, sing-box shuts down cleanly, the TUN adapter is destroyed, routes are removed, and you're never left without internet\n- **Automatic exclusion** of tor.exe, sing-box.exe, lyrebird.exe and onionymous.exe from the tunnel to prevent infinite loops\n- **Pre-resolved DNS** through Tor to prevent leaks (reverse_mapping enabled in sing-box)\n- **UDP redirected** to direct-out (Tor doesn't support UDP) instead of failing silently\n\n🌍 **Exit country selector improvements**\n\nVisual availability indicators in the dropdown:\n\n- **★ High availability** (Germany, Netherlands, US, France, Switzerland, etc.)\n- *(no marker)* Medium availability\n- **⚠ Few exit nodes**, may fail (Portugal, Argentina, Israel, Mexico, etc.)\n\n\u003ch1 align=\"center\"\u003e\u003c/h1\u003e\n\n### 📦 Installation\n\nDownload `onionymous.exe` from the [Releases](https://github.com/R3LI4NT/Onionymous/releases) page and run it.\n\nThat's it. The `.exe` is fully self-contained — no installer, no runtime dependencies.\n\n### 🔨 Building from source\n\nRequirements:\n- [Rust 1.78+](https://rustup.rs)\n- `tar.exe` and `curl.exe` (both ship with Windows 10 1803+)\n\n```powershell\n# 1. Fetch the Tor Expert Bundle once. This downloads tor.exe, geoip\n#    databases and the pluggable transports into ./resources/tor/.\n#    MUST run BEFORE cargo build — the binaries are embedded into the\n#    .exe at compile time.\n.\\download-requeriments.bat\n\n# 2. Build the portable release executable.\ncargo build --release\n```\n\nThe resulting `target\\release\\onionymous.exe` is around **90 MB** (Tor + pluggable transports are embedded) and fully portable. Move it wherever you like.\n\nFor faster iteration during development:\n```powershell\ncargo build --no-default-features\nCopy-Item -Recurse -Force .\\resources .\\target\\debug\\resources\n```\n\n### 📜 License\n\nMIT. See [LICENSE](LICENSE).\n\n---\n\n\u003ca id=\"español\"\u003e\u003c/a\u003e\n\n## Español\n\n### Resumen\n\n**Onionymous** es una aplicación nativa de escritorio para Windows que enruta tu tráfico a través de la red Tor con una UI moderna y cuidada. El binario oficial de Tor, las bases de datos geoip y los pluggable transports vienen todos embebidos dentro de un único `.exe` portable — sin instalador, sin carpetas aparte, sin archivos de configuración para editar a mano.\n\nEstá pensado para quienes quieren los beneficios de privacidad y anti-censura de Tor sin la complejidad de correr Tor manualmente o configurar un proxy SOCKS a mano. Onionymous maneja el proceso de Tor por vos, observa el bootstrap en tiempo real, rota identidades cuando lo pedís, y te muestra el estado de conexión y ancho de banda de un vistazo.\n\n### 🆕 Características (v1.0)\n\n#### 🎯 Control de conexión\n- **UX click-en-el-orb** — el círculo animado central *es* el botón de conectar/desconectar. Sin botones extra que ensucien el dashboard\n- **Progreso de bootstrap en vivo** pintado como un arco que se llena alrededor del orb, siguiendo el porcentaje de bootstrap de Tor en tiempo real\n- **Feedback visual para cada estado** — icono de power cuando está apagado, spinner mientras conecta, shield-check cuando está conectado, warning en caso de falla\n- **Glow pulsante** cuando está conectado, sonidos direccionales al cambiar de estado\n- **IP pública en ámbar** en el dashboard, actualizada en cada conexión y después de cada rotación de identidad\n- **Limpieza automática** de procesos `tor.exe` zombi que ocuparían el puerto SOCKS al reiniciar\n\n#### 🌐 Enrutamiento y privacidad\n- **Proxy SOCKS5 local** en `127.0.0.1:9050` — las apps compatibles con Tor se enrutan automáticamente vía el proxy del sistema\n- **Selector de país de salida** — elegí entre 40+ países para tu relay de salida, o dejalo en *Automático*\n- **Lista de países excluidos** — vetá permanentemente países para que nunca se usen como guard/middle/exit\n- **Puentes / pluggable transports** para redes censuradas:\n  - **obfs4** — el más común, rápido, bueno para censura leve\n  - **Snowflake** — basado en WebRTC, bueno para censura fuerte\n  - **Puentes personalizados** — pegá tus propias líneas desde bridges.torproject.org\n- **Botón Nueva Identidad** — fuerza a Tor a reconstruir circuitos y presentar una IP nueva\n- **Botón Actualizar IP** — vuelve a consultar tu IP pública sin reconstruir circuitos\n\n#### 🛡️ Seguridad\n- **Kill Switch** vía Windows Defender Firewall — bloquea todo el tráfico no-Tor a nivel OS (requiere admin). Se desactiva automáticamente al desconectar para que nunca te quedes sin internet\n- **Detección automática de admin** — el switch se ofrece pero se omite limpiamente si corrés como usuario normal, con un mensaje claro en el log en lugar de fallar silenciosamente\n- **Control port con cookie authentication** — cero contraseñas en disco, Tor rota la cookie en cada arranque\n\n#### 📊 Observabilidad\n- **Sparkline de ancho de banda en tiempo real** con descarga en violeta y subida en ámbar, ventana rolante de 60 muestras, normalizada al pico local\n- **Totales de sesión** para bytes leídos y escritos\n- **Registro completo de eventos** combinando Tor + app, filtrable por origen y nivel, con auto-scroll al pie\n- **Card de resumen del circuito** mostrando país de salida y estado de puentes de un vistazo\n\n#### 🔧 Herramientas\n- **Botón Actualizar Tor** — descarga el Tor Expert Bundle más reciente directamente del archivo oficial del Tor Project en `archive.torproject.org`, verifica el checksum SHA-256 contra el manifiesto firmado `sha256sums-signed-build.txt`, e instala los binarios nuevos de forma atómica\n- **Terminal en vivo** con líneas timestamped y coloreadas por nivel de severidad mientras corre la actualización\n- **Detección de versión instalada** con timestamp de la última actualización exitosa, cacheada por sesión para no golpear `tor.exe` en cada frame\n\n#### 🎨 Experiencia de usuario\n- **Tema violeta propio** con blur DWM Mica / Acrylic en Windows 10 y 11\n- **Orb circular animado** como elemento focal de la UI — pintado desde cero con la API painter de egui\n- **Phosphor Icons** en toda la app para iconografía consistente y nítida que renderiza en cualquier sistema independientemente de las fuentes instaladas\n- **Sonidos UI sintetizados** — click, tick, chirp de conexión, chirp de desconexión, warble de error — todos generados en memoria por `rodio`, cero archivos de audio empaquetados\n- **Bilingüe** — inglés y español, intercambiables en tiempo real con el botón del globo en el header\n- **Portabilidad real** — el `.exe` extrae su runtime embebido a `%LocalAppData%\\Onionymous\\runtime\\\u003cversión\u003e\\` en el primer arranque, y después corre desde ese cache. Movelo donde quieras y sigue funcionando\n\n#### 🖥️ Integración con el sistema\n- **Iniciar con Windows** vía `HKCU\\...\\Run` (entrada de registro idempotente)\n- **Iniciar minimizado** cuando arranca por autostart\n- **Minimizar a la bandeja al cerrar** (opcional, desactivado por defecto para no confundir al usuario nuevo)\n- **Botón Salir** — desconecta Tor, saca el proxy, desmonta el kill switch, y cierra la app de forma limpia\n\n\u003ch1 align=\"center\"\u003e\u003c/h1\u003e\n\n### 🆕 Características (v1.1)\n\n🌐 TUN/VPN Mode (admin) \n\n- **Routing de todo el sistema operativo** a través de Tor, no solo apps proxy-aware. Cualquier programa (incluso los que ignoran el proxy del sistema) pasa por la red Tor cuando este modo está activo\n- **Implementado con Wintun** (driver TUN oficial de WireGuard) + sing-box como motor TUN→SOCKS bridging, ambos embebidos en el .exe\n- **Selector de modo en el home:** Proxy o TUN/VPN — el usuario elige según necesite\n- **Detección automática de admin** — si elegís TUN sin ser admin, te avisa claramente; si la creación del túnel falla por cualquier razón, hace fallback automático a modo Proxy sin romper la conexión\n- **Cleanup robusto** — al desconectar, sing-box se cierra limpio, el adaptador TUN se destruye, las rutas se quitan, y nunca te quedás sin internet\n- **Excluye automáticamente** tor.exe, sing-box.exe, lyrebird.exe y onionymous.exe del túnel para evitar loops infinitos\n- **DNS pre-resuelto** a través de Tor para evitar leaks (reverse_mapping activado en sing-box)\n- **UDP redirigido** a direct-out (Tor no soporta UDP) en lugar de fallar silenciosamente\n\n🌍 Mejoras en el selector de país de salida\nIndicadores visuales de disponibilidad en el dropdown:\n\n- **★ Alta disponibilidad** (Germany, Netherlands, US, France, Switzerland, etc.)\n(sin marcador) disponibilidad media\n- **⚠ Pocos exit** nodes, puede fallar (Portugal, Argentina, Israel, Mexico, etc.)\n\n\u003ch1 align=\"center\"\u003e\u003c/h1\u003e\n\n### 📦 Instalación\n\nDescargá `onionymous.exe` de la página de [Releases](https://github.com/R3LI4NT/Onionymous/releases) y ejecutalo.\n\nY listo. El `.exe` es totalmente autónomo — sin instalador, sin dependencias de runtime.\n\n### 🔨 Compilar desde el código fuente\n\nRequisitos:\n- [Rust 1.78+](https://rustup.rs)\n- `tar.exe` y `curl.exe` (ambos vienen con Windows 10 1803+)\n\n```powershell\n# 1. Descargar el Tor Expert Bundle una sola vez. Esto baja tor.exe,\n#    las bases de datos geoip y los pluggable transports a ./resources/tor/.\n#    SE DEBE ejecutar ANTES de cargo build — los binarios se embeben en\n#    el .exe en tiempo de compilación.\n.\\download-requeriments.bat\n\n# 2. Build del ejecutable portable en release.\ncargo build --release\n```\n\nEl `target\\release\\onionymous.exe` resultante pesa alrededor de **90 MB** (Tor + pluggable transports embebidos) y es totalmente portable. Movelo a donde quieras.\n\nPara iteración más rápida durante desarrollo:\n```powershell\ncargo build --no-default-features\nCopy-Item -Recurse -Force .\\resources .\\target\\debug\\resources\n```\n\n### 📜 Licencia\n\nMIT. Ver [LICENSE](LICENSE).\n\n\u003ch1 align=\"center\"\u003e\u003c/h1\u003e\n\n\u003cimg src=\"https://img.shields.io/badge/r3li4nt.contact@keemail.me-4C1783?style=for-the-badge\u0026logo=gmail\u0026logoColor=white\" /\u003e\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003csub\u003eDeveloper: #R3LI4NT\u003c/sub\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fr3li4nt%2Fonionymous","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fr3li4nt%2Fonionymous","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fr3li4nt%2Fonionymous/lists"}