elector

TOR BROWSER IN ELECTRON

NOTE:

Version 2.0 - Now using modern Electron with enhanced security features!

WHY?:

"A super lightweight Tor-connected browser built with modern web technologies."

Elector is a simple browser that auto-connects to your local Tor service. If you're running Tor via homebrew on macOS, this app works out of the box. For other setups, you may need to configure your torrc file.

SECURITY IMPROVEMENTS (v2.0):

✅ Updated to Electron 33+ with latest security patches ✅ Sandboxed renderer processes enabled by default (resolves issue #3) ✅ Context isolation to prevent XSS attacks ✅ No Node.js integration in renderer for better security ✅ Follows modern Electron security best practices

FORK ME:

Please fork and make this better.
READ the CONTRIBUTING doc for tips on how to help with this project. Thank you!

Download Pre-built Binaries

Download the latest release for your platform from the Releases page.

Automated builds are created on every push to master via GitHub Actions.

Install instructions

1. Install Tor (required prerequisite):

   • macOS: brew install tor && brew services start tor
   • Linux: sudo apt install tor && sudo systemctl start tor
   • Windows: Download from torproject.org

2. Run from source:

git clone https://github.com/jamesacampbell/elector.git
cd elector
npm install
npm start

3. Build locally:

npm run build          # Build for current platform
npm run build:mac      # macOS
npm run build:linux    # Linux
npm run build:win      # Windows

Configuration

Elector is configured to route all traffic through the SOCKS5 proxy at 127.0.0.1:9050 (default Tor port).

Tor v3 Onion Addresses

Note: Modern Tor uses longer v3 onion addresses (56 characters). Old v2 addresses (16 characters) are deprecated and no longer work.

Example v3 address:

https://duckduckgogg42xjoc72x3sjasowoarfbgcmvfimaftt6twagswzczad.onion/

Recommended Tor Sites

Note: HTTP is used for .onion addresses because Tor already provides end-to-end encryption. HTTPS works too but isn't necessary for privacy.

🔍 Search Engines

• DuckDuckGo: http://duckduckgogg42xjoc72x3sjasowoarfbgcmvfimaftt6twagswzczad.onion/
  • Privacy-focused search engine (default homepage)
• Ahmia: http://juhanurmihxlp77nkq76byazcldy2hlmovfu2epvl5ankdibsot4csyd.onion/
  • Search engine for onion services

📰 News & Media

• ProPublica: http://p53lf57qovyuvwsc6xnrppyply3vtqm7l6pcobkmyqsiofyeznfu5uqd.onion/
  • Investigative journalism
• BBC News: http://bbcnewsd73hkzno2ini43t4gblxvycyac5aw4gnv7t2rccijh7745uqd.onion/
  • International news service
• The New York Times: http://ej3kv4ebuugcmuwxctx5ic7zxh73rnxt42soi3tdneu2c2em55thufqd.onion/
  • US newspaper

🗂️ Directories & Wikis

• The Hidden Wiki: http://zqktlwiuavvvqqt4ybvgvi7tyo4hjl5xgfuvpdf6otjiycgwqbym2qad.onion/wiki/
  • Directory of onion sites
• Daniel's Onion List: http://danielas3rtn54uwmofdo3x2bsdifr47huasnmbgqzfrec5ubupvtpid.onion/
  • Curated list of verified onion sites

🔐 Privacy & Security

• Tor Project: http://2gzyxa5ihm7nsggfxnu52rck2vv4rvmdlkiu3zzui5du4xyclen53wid.onion/
  • Official Tor Project site
• Riseup: http://vww6ybal4bd7szmgncyruucpgfkqahzddi37ktceo3ah7ngmcopnpyyd.onion/
  • Secure communication tools
• SecureDrop Directory: http://sdolvtfhatvsysc6l34d65ymdwxcujausv7k5jk4cy5ttzhjoi6fzvyd.onion/
  • Anonymous document submission

📚 Libraries & Archives

• Internet Archive: http://archiveiya74codqgiixo33q62qlrqtkgmcitqx5u2oeqnmn5bpcbiyd.onion/
  • Digital library of websites, books, and media
• Z-Library: http://loginzlib2vrak5zzpcocc3ouizykn6k5qecgj2tzlnab5wcbqhembyd.onion/
  • Free eBook library
• Imperial Library: http://kx5thpx2olielkihfyo4jgjqfb7zx7wxr3sd4xzt26ochei4m6f7tayd.onion/
  • Free book collection

💬 Communication

• ProtonMail: http://protonmailrmez3lotccipshtkleegetolb73fuirgj7r4o4vfu7ozyd.onion/
  • Encrypted email service
• Keybase: http://keybase5wmilwokqirssclfnsqrjdsi7jdir5wy7y7iu3tanwmtp6oid.onion/
  • Secure messaging and file sharing

🛡️ Whistleblowing

• WikiLeaks: Search for current onion address via their clearnet site
  • Note: WikiLeaks onion address changes periodically for security
• The Intercept SecureDrop: http://27m3p2uv7igmj6kvd4ql3cct5h3sdwrsajovkkndeufumzyfhlfev4qd.onion/
  • Submit documents anonymously

⚠️ Safety Tips

• Always verify onion addresses from official sources
• Onion addresses can change - bookmark trusted directories
• Be cautious of phishing sites with similar addresses
• Never enter personal information unless you trust the site

Testing Your Connection

To verify Tor is working:

1. Visit: https://check.torproject.org/
2. You should see: "Congratulations. This browser is configured to use Tor."