{"id":38215869,"url":"https://github.com/codingstark-dev/backupmail","last_synced_at":"2026-01-19T18:02:22.433Z","repository":{"id":332803139,"uuid":"1133456267","full_name":"codingstark-dev/backupmail","owner":"codingstark-dev","description":"Universal email backup and migration TUI \u0026 CLI tool for Gmail, SpaceMail, and IMAP servers - Built with Bun!","archived":false,"fork":false,"pushed_at":"2026-01-15T15:25:11.000Z","size":1020,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-15T19:09:24.304Z","etag":null,"topics":["backup","bunjs","gmail","imap","migration","opentui","spacemail","tui"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/codingstark-dev.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-01-13T11:22:18.000Z","updated_at":"2026-01-15T15:25:17.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/codingstark-dev/backupmail","commit_stats":null,"previous_names":["codingstark-dev/backupmail"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/codingstark-dev/backupmail","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codingstark-dev%2Fbackupmail","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codingstark-dev%2Fbackupmail/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codingstark-dev%2Fbackupmail/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codingstark-dev%2Fbackupmail/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codingstark-dev","download_url":"https://codeload.github.com/codingstark-dev/backupmail/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codingstark-dev%2Fbackupmail/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28543495,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T14:59:57.589Z","status":"ssl_error","status_checked_at":"2026-01-18T14:59:46.540Z","response_time":98,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["backup","bunjs","gmail","imap","migration","opentui","spacemail","tui"],"created_at":"2026-01-17T00:47:41.926Z","updated_at":"2026-01-18T17:00:46.110Z","avatar_url":"https://github.com/codingstark-dev.png","language":"TypeScript","readme":"# 📧 mailbak\n\n\u003e Universal email backup and migration tool with an interactive cyberpunk TUI\n\n[![npm version](https://badge.fury.io/js/mailbak.svg)](https://www.npmjs.com/package/mailbak)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nFast and secure email backup tool supporting Gmail, JMAP (Fastmail), IMAP servers, and multiple export formats. Features both CLI and an interactive cyberpunk-themed TUI.\n\n## 📸 Screenshots\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"img/1.png\" alt=\"mailbak TUI - Main Menu\" width=\"600\"\u003e\n  \u003cbr\u003e\n  \u003cem\u003eCyberpunk-themed TUI with neon colors\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"img/2.png\" alt=\"mailbak TUI - Backup Progress\" width=\"600\"\u003e\n  \u003cbr\u003e\n  \u003cem\u003eReal-time backup progress tracking\u003c/em\u003e\n\u003c/p\u003e\n\n## ✨ Features\n\n- 🎨 **Interactive TUI** - Cyberpunk-themed terminal interface with neon colors\n- 📦 **Multiple Formats** - Export to MBOX, EML, and JSON\n- 🔐 **Secure** - OAuth2 for Gmail, encrypted credential storage\n- 🚀 **Fast** - Built with Bun for maximum performance\n- 🔗 **JMAP Support** - Modern email protocol for Fastmail and compatible servers\n- 📁 **Flexible** - Backup to local storage, home directory, or custom paths\n- 🔄 **Migration** - Transfer emails between different accounts\n- 💾 **Zero Dependencies** - Uses Bun's built-in features\n\n## 🚀 Installation\n\n```bash\n# Using npm\nnpm install -g mailbak\n\n# Using bun (recommended)\nbun install -g mailbak\n\n# From source\ngit clone https://github.com/codingstark-dev/backupmail\ncd backupmail\nbun install\n```\n\n## 📖 Usage\n\n### Interactive TUI (Default)\n\nSimply run `mailbak` to launch the cyberpunk TUI:\n\n```bash\nmailbak\n```\n\nNavigate with arrow keys and enjoy the cyberpunk interface!\n\n### CLI Mode\n\nUse with arguments to enter CLI mode:\n\n```bash\n# Show help\nmailbak --help\n\n# Show version\nmailbak --version\n\n# Add account\nmailbak auth add\n\n# List accounts\nmailbak auth list\n\n# Backup emails\nmailbak backup \u003caccountId\u003e --format mbox --output ./backups\n\n# Migrate between accounts\nmailbak migrate \u003cfromAccountId\u003e \u003ctoAccountId\u003e\n```\n\n## 🎮 TUI Features\n\n- ASCII art logo with neon glow effects\n- Real-time backup progress tracking\n- Multiple export location options (current dir, home dir, custom path)\n- Format selection wizard (MBOX, EML, JSON)\n- Cyberpunk color scheme (neon cyan, magenta, green)\n\n### Navigation\n- `↑/↓` - Navigate menus\n- `Enter` - Select option\n- `Esc` - Go back\n- `q` - Quit\n\n## 📦 Supported Formats\n\n### MBOX\nStandard Unix mailbox format\n- Compatible with: Thunderbird, Apple Mail, Gmail import\n\n### EML\nIndividual email files\n- Compatible with: Outlook, Windows Mail\n\n### JSON\nStructured metadata\n- Use case: Data analysis, custom processing\n\n## 🔧 Configuration\n\nConfig stored in `~/.mailbak/`:\n```\n~/.mailbak/\n├── config.json\n└── credentials/\n```\n\n## 🌟 Supported Providers\n\n- ✅ Gmail (OAuth2)\n- ✅ JMAP (Fastmail and any JMAP-compliant server)\n- ✅ Generic IMAP\n- ✅ SpaceMail\n- ✅ Any IMAP-compatible service\n\n### JMAP Support\n\n[JMAP](https://jmap.io/) is the modern, open standard for email access (RFC 8620, RFC 8621). It's faster and more efficient than IMAP, especially for mobile and web applications.\n\n**Supported JMAP providers:**\n- Fastmail (pre-configured)\n- Any JMAP-compliant server (custom URL)\n\n```bash\n# Add a JMAP account via CLI\nmailbak auth add\n# Select \"JMAP (Fastmail, etc.)\"\n\n# Or use the TUI\nmailbak\n# Navigate to \"Add Account\" → \"JMAP (Fastmail, etc.)\"\n```\n\n## 💻 Development\n\n```bash\n# Install dependencies\nbun install\n\n# Run in TUI mode (default)\nbun run dev\n\n# Run with CLI arguments\nbun run dev -- --help\nbun run dev -- auth list\n\n# Build\nbun run build\n\n# Test\nbun test\n```\n\n## 🤝 Contributing\n\nContributions welcome! Please:\n1. Fork the repository\n2. Create feature branch\n3. Add tests\n4. Submit pull request\n\n## 📄 License\n\nMIT © [codingstark-dev](https://github.com/codingstark-dev)\n\n## 🔗 Links\n\n- [GitHub](https://github.com/codingstark-dev/backupmail)\n- [npm](https://www.npmjs.com/package/mailbak)\n- [Issues](https://github.com/codingstark-dev/backupmail/issues)\n\n---\n\nMade with ❤️ using [Bun](https://bun.sh/) and [OpenTUI](https://github.com/anomalyco/opentui)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodingstark-dev%2Fbackupmail","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodingstark-dev%2Fbackupmail","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodingstark-dev%2Fbackupmail/lists"}