GitHub - JB-SelfCompany/Tyr: True P2P Email on top of Yggdrasil Network

Skip to content

Navigation Menu

Toggle navigation

Sign in

Appearance settings

PlatformAI CODE CREATIONGitHub CopilotWrite better code with AIGitHub SparkBuild and deploy intelligent appsGitHub ModelsManage and compare promptsMCP RegistryNewIntegrate external toolsDEVELOPER WORKFLOWSActionsAutomate any workflowCodespacesInstant dev environmentsIssuesPlan and track workCode ReviewManage code changesAPPLICATION SECURITYGitHub Advanced SecurityFind and fix vulnerabilitiesCode securitySecure your code as you buildSecret protectionStop leaks before they startEXPLOREWhy GitHubDocumentationBlogChangelogMarketplaceView all featuresSolutionsBY COMPANY SIZEEnterprisesSmall and medium teamsStartupsNonprofitsBY USE CASEApp ModernizationDevSecOpsDevOpsCI/CDView all use casesBY INDUSTRYHealthcareFinancial servicesManufacturingGovernmentView all industriesView all solutionsResourcesEXPLORE BY TOPICAISoftware DevelopmentDevOpsSecurityView all topicsEXPLORE BY TYPECustomer storiesEvents & webinarsEbooks & reportsBusiness insightsGitHub SkillsSUPPORT & SERVICESDocumentationCustomer supportCommunity forumTrust centerPartnersOpen SourceCOMMUNITYGitHub SponsorsFund open source developersPROGRAMSSecurity LabMaintainer CommunityAcceleratorArchive ProgramREPOSITORIESTopicsTrendingCollectionsEnterpriseENTERPRISE SOLUTIONSEnterprise platformAI-powered developer platformAVAILABLE ADD-ONSGitHub Advanced SecurityEnterprise-grade security featuresCopilot for BusinessEnterprise-grade AI featuresPremium SupportEnterprise-grade 24/7 supportPricing

Search or jump to...

Search code, repositories, users, issues, pull requests...

Search

Clear

Search syntax tips

Provide feedback

We read every piece of feedback, and take your input very seriously.

Include my email address so I can be contacted

Cancel

Submit feedback

Saved searches

Use saved searches to filter your results more quickly

Name

Query

To see all available qualifiers, see our documentation.

Cancel

Create saved search

Sign in

Sign up

Appearance settings

Resetting focus

You signed in with another tab or window. Reload to refresh your session.
You signed out in another tab or window. Reload to refresh your session.
You switched accounts on another tab or window. Reload to refresh your session.

Dismiss alert

JB-SelfCompany

/

Tyr

Public

Notifications
You must be signed in to change notification settings

Fork
11

Star
169

True P2P Email on top of Yggdrasil Network

License

AGPL-3.0 license

169
stars

11
forks

Branches

Tags

Activity

Star

Notifications
You must be signed in to change notification settings

Code

Issues
3

Pull requests
0

Actions

Projects
0

Security

Uh oh!

There was an error while loading. Please reload this page.

Insights

Additional navigation options

Code

Issues

Pull requests

Actions

Projects

Security

Insights

JB-SelfCompany/Tyr

 mainBranchesTagsGo to fileCodeOpen more actions menuFolders and filesNameNameLast commit messageLast commit dateLatest commit History23 Commitsappapp  fastlane/metadata/androidfastlane/metadata/android  gradle/wrappergradle/wrapper  .gitignore.gitignore  LICENSELICENSE  README.mdREADME.md  README.ru.mdREADME.ru.md  build.gradlebuild.gradle  gradle.propertiesgradle.properties  gradlewgradlew  gradlew.batgradlew.bat  settings.gradlesettings.gradle  View all filesRepository files navigationREADMEAGPL-3.0 license
Tyr
True Peer-to-Peer Email on Yggdrasil Network

English | Русский

🌐 What is Tyr?
We're taught that email must go through servers. Why? Because the Internet was built around centralized infrastructure. Every email you send travels through multiple servers - your provider's server, maybe a few relay servers, and finally your recipient's provider's server. Each hop is a potential point of surveillance, censorship, or failure.
Even "encrypted" email solutions still rely on these centralized servers. They encrypt the message content but the metadata - who you're talking to, when, how often - is visible to anyone watching the servers.
But there is a network, called Yggdrasil, that gives everyone a free IPv6 and doesn't need a blessing from your ISP. We finally have this possibility to use true P2P email. And moreover, this network has strong encryption to protect all data that flows from one IP to another.
Tyr brings true peer-to-peer email to your Android device using these unusual conditions. Unlike traditional email clients, Tyr doesn't need:

❌ Centralized mail servers (the connections are straight P2P)
❌ Message encryption layers (the network takes care of that)
❌ Port forwarding or STUN/TURN servers (Yggdrasil handles NAT traversal)

✨ Features

Feature
Description

🔗 Full DeltaChat/ArcaneChat Integration
Seamless setup with the best decentralized messengers

📧 Local SMTP/IMAP Server
Complete mail server running directly on your device

🔐 Cryptographic Identity
Automatic Ed25519 key generation - your mail identity cannot be spoofed

🌍 Yggdrasil Network
Connect via configurable peers - censorship-resistant by design

🚀 Auto-Start on Boot
Always-on availability for incoming messages

💾 Encrypted Backup & Restore
Password-protected configuration with optional key export

🔋 Battery Optimized
Sophisticated power management with timed wake locks

🛠️ How It Works

graph LR
A[DeltaChat/ArcaneChat] -->|SMTP/IMAP| B[Tyr Service]
B -->|Yggmail Protocol| C[Yggdrasil Network]
C -->|P2P Encrypted| D[Recipient's Tyr]
D -->|SMTP/IMAP| E[Recipient's Chat App]

Loading

Tyr runs a complete email server right on your Android device, using the Yggdrasil network for transport. The Yggmail mail server (built in Go) is embedded as a library inside the app and runs as a foreground service.
On top of Yggdrasil, it provides standard SMTP and IMAP protocols on localhost (127.0.0.1:1025 and 127.0.0.1:1143). Any email client can connect to these ports - but we recommend DeltaChat or ArcaneChat for the best P2P messaging experience.
📬 Mail Address Format
Every Tyr installation generates unique Ed25519 cryptographic keys. Your mail address is derived from your public key:
<64-hex-characters>@yggmail

This means your identity is cryptographically verifiable and cannot be spoofed.

📱 Quick Start
Setting up DeltaChat/ArcaneChat
Option 1: Automatic Setup (Recommended)

Install Tyr and complete the onboarding (set password, configure peers)
Start the Yggmail service in Tyr
Install DeltaChat or ArcaneChat
In Tyr's main screen, tap "Setup DeltaChat/ArcaneChat"
Tyr will automatically open your chat app with pre-configured settings
Complete the setup and start chatting!

Option 2: Manual Setup
If automatic setup doesn't work:

Complete Tyr onboarding and start the service
Copy your mail address from Tyr's main screen (looks like abc123...@yggmail)
In DeltaChat/ArcaneChat, create a new profile
Tap "Use a different server"
Enter your Yggmail address and the password you set in Tyr
Tap "✓" to complete setup

Important: Tyr must be running for your chat app to send and receive messages. Enable auto-start in Tyr settings for seamless experience.

🔒 Security Features

Password Encryption: Android Keystore System with AES-256-GCM
Automatic Keystore Recovery: Handles Android Keystore issues on Samsung and other devices
Network Encryption: All P2P communications encrypted by Yggdrasil Network
Local-Only Access: SMTP/IMAP ports bound to localhost only
Cryptographic Identity: Ed25519 keys ensure your mail address cannot be spoofed
Encrypted Backups: Configuration and keys backed up with password protection

🏗️ Building from Source
Prerequisites

Android Studio (latest version)
JDK 17
Android SDK (API 23-36)
Go 1.21+ and gomobile (only if rebuilding yggmail.aar)

Build Commands
# Clone the repository
git clone https://github.com/JB-SelfCompany/Tyr.git
cd Tyr

# Build debug APK
./gradlew assembleDebug

# Install to connected device
./gradlew installDebug
APKs will be in app/build/outputs/apk/debug/ or app/build/outputs/apk/release/
Rebuilding yggmail.aar (optional)
cd ../yggmail/mobile

# Windows
..\build-android.bat

# Unix
gomobile bind -target=android -androidapi 23 -javapkg=com.jbselfcompany.tyr -ldflags="-checklinkname=0" -o yggmail.aar .
Then copy yggmail.aar to Tyr/app/libs/

🔧 Technical Details

Component
Details

Language
Kotlin 2.2.20

Min SDK
23 (Android 6.0)

Target SDK
33 (Android 13)

Compile SDK
36

Architecture
Layered (UI → Service → Data)

Mail Server
Yggmail (Go library via gomobile)

Network
Yggdrasil overlay mesh network

Localization
English, Russian

Native Library
yggmail.aar (located in app/libs/)

🤝 Related Projects

Yggmail: The mail transfer agent that powers Tyr
Mimir: P2P messenger on Yggdrasil (sister project)
Yggdrasil Network: The mesh network infrastructure
DeltaChat: Recommended email-based messenger client
ArcaneChat: Alternative email-based messenger client

📄 License
Tyr is open source software. The Yggmail library uses Mozilla Public License v. 2.0.
See LICENSE file for full details.

🌟 Why P2P Email Matters

Censorship Circumvention: Connect to any of hundreds of available Yggdrasil nodes, host your own, or even build a private network. Email freedom is literally in your hands.

Privacy by Design: No metadata collection, no server logs, no third-party surveillance. Your conversations belong to you.

Decentralization: No single point of failure, no corporate control. True peer-to-peer architecture.

Made with ❤️ for the decentralized web
Report Bug · Request Feature

About

True P2P Email on top of Yggdrasil Network

Resources

Readme

License

AGPL-3.0 license

Uh oh!

There was an error while loading. Please reload this page.

Activity
Stars

169
stars
Watchers

2
watching
Forks

11
forks

Report repository

Releases
13

v1.4.3

Latest

Nov 30, 2025

+ 12 releases

Languages

Kotlin
100.0%

Footer

© 2025 GitHub, Inc.

Footer navigation

Terms

Privacy

Security

Status

Community

Docs

Contact

Manage cookies

Do not share my personal information

You can’t perform that action at this time.

Tyr represents a radical departure from traditional email infrastructure, offering a truly peer-to-peer email solution built upon the Yggdrasil network. This project, spearheaded by JB-SelfCompany, aims to address concerns surrounding centralized email systems – namely, the potential for surveillance, censorship, and single points of failure. The core innovation lies in leveraging the Yggdrasil network, an IPv6-only overlay mesh network designed to avoid reliance on traditional Internet Service Providers and their associated control. The software, implemented primarily in Kotlin, functions by running a complete email server – Yggmail – directly on the user’s Android device, utilizing the Yggmail library built via gomobile.

Key features of Tyr include a localized SMTP/IMAP server, cryptographic identity management through Ed25519 keys, full delta/arcanechat integration, and robust security measures. The system’s architecture is layered, with a user interface, a service layer managing the core email operations, and data access. The incorporation of the Yggdrasil network is central to the solution, providing a censorship-resistant communication channel and eliminating the need for traditional mail servers, which are often susceptible to government control and surveillance. The project also prioritizes the security of the user’s data by employing AES-256-GCM encryption for password protection, automatic keystore recovery, and strict localization of SMTP/IMAP ports to localhost only, minimizing external exposure.

The development process involves a layered approach, with detailed instructions for building from source, utilizing Android Studio, and necessary prerequisites such as the Java Development Kit (JDK 17) and Android SDK. The project provides clear build commands for both Windows and Unix-based systems, facilitating the developer’s ability to test and refine the software. The core innovation demonstrates the potential of decentralized technologies for enhancing privacy and security in communication.

The implementation demonstrates a commitment to open-source development, utilizing the Mozilla Public License v. 2.0 for the Yggmail library. The project is structured around key components, including an interface, a service layer (Yggmail), and data access. Notable features include automatic keystore recovery, localized SMTP/IMAP ports bound to localhost, Ed25519 key management for cryptographic identity, supported by a user-friendly build process. The reliance on the Yggdrasil network presents a unique approach to addressing concerns surrounding centralized control in digital communication, offering a pathway towards greater user autonomy and a more resilient communication infrastructure. The project’s documentation thoroughly outlines its architecture and functionality, making it accessible to a skilled technical audience seeking to understand and potentially contribute to its development.