{"id":45015267,"url":"https://github.com/abusoww/tuxmate","last_synced_at":"2026-02-28T07:00:51.476Z","repository":{"id":330405594,"uuid":"1122062847","full_name":"abusoww/tuxmate","owner":"abusoww","description":"THE MISSING BULK APP INSTALLER FOR LINUX","archived":false,"fork":false,"pushed_at":"2026-02-22T00:52:36.000Z","size":4051,"stargazers_count":1721,"open_issues_count":5,"forks_count":78,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-02-22T01:12:09.337Z","etag":null,"topics":["arch","debian","flatpa","linux","nix","package-manager","tool","ubuntu","web"],"latest_commit_sha":null,"homepage":"https://tuxmate.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/abusoww.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2025-12-24T03:35:39.000Z","updated_at":"2026-02-22T00:52:39.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/abusoww/tuxmate","commit_stats":null,"previous_names":["abusoww/tuxmate"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/abusoww/tuxmate","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abusoww%2Ftuxmate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abusoww%2Ftuxmate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abusoww%2Ftuxmate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abusoww%2Ftuxmate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/abusoww","download_url":"https://codeload.github.com/abusoww/tuxmate/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abusoww%2Ftuxmate/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29927172,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-27T19:37:42.220Z","status":"online","status_checked_at":"2026-02-28T02:00:07.010Z","response_time":90,"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":["arch","debian","flatpa","linux","nix","package-manager","tool","ubuntu","web"],"created_at":"2026-02-19T01:00:33.254Z","updated_at":"2026-02-28T07:00:51.386Z","avatar_url":"https://github.com/abusoww.png","language":"TypeScript","funding_links":[],"categories":["linux","Table of Contents"],"sub_categories":["Cleaner"],"readme":"\u003c!-- markdownlint-disable MD041 --\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ch1\u003e\u003ca href=\"https://tuxmate.abusov.com/\"\u003e\u003cimg alt=\"TuxMate\" src=\"TUXMATE.png\" width=600/\u003e\u003c/a\u003e\u003c/h1\u003e\n\n![Linux](https://img.shields.io/badge/Linux-FCC624?style=for-the-badge\u0026logo=linux\u0026logoColor=black)\n![Website](https://img.shields.io/website?url=https://tuxmate.abusov.com\u0026style=for-the-badge)\n![Maintained](https://img.shields.io/badge/Maintained-Yes-green?style=for-the-badge)\n[![GitHub issues](https://img.shields.io/github/issues/abusoww/tuxmate?color=red\u0026style=for-the-badge)](https://github.com/abusoww/tuxmate/issues)\n[![GitHub stars](https://img.shields.io/github/stars/abusoww/tuxmate?color=green\u0026style=for-the-badge)](https://github.com/abusoww/tuxmate/stargazers)\n[![GitHub license](https://img.shields.io/github/license/abusoww/tuxmate?color=yellow\u0026style=for-the-badge)](https://github.com/abusoww/tuxmate/blob/main/LICENSE)\n\n\u003c/div\u003e\n\n## 🐧 The only Mate you need for setup\n\n**TuxMate** is a simple web tool that generates install scripts for any Linux distro. Pick your apps, copy the command, done.\n\nFresh install? New machine? Can't remember every package name? We've all been there.\n\n\n## 📦 Supported Package Managers\n\n- Ubuntu / Debian (apt)\n- Arch Linux (pacman + AUR)\n- Fedora (dnf)\n- openSUSE (zypper)\n- Nix (declarative config)\n- Flatpak\n- Snap\n- Homebrew (macOS + Linux)\n\n## ✨ Features\n\n### **Application Catalog**  \n180+ applications across 15 categories: browsers, communication, dev tools, terminals, media, creative software, gaming, office, VPN/network, security, and more.\n\n### **Smart Script Generation**  \n- Detects already-installed packages\n- Handles AUR packages automatically on Arch\n- **Nix Unfree Detection**: Warns compliant configuration for unfree packages (Discord, Spotify, etc.)\n- Homebrew formula/cask separation for macOS\n- Parallel installation for Flatpak\n- Network retry with exponential backoff\n- Progress bars with ETA\n- Colored output and summary reports\n\n\n\n\n\n## 📸 Screenshots\n\n![1](src/screenshots/1.png)\n![2](src/screenshots/2.png)\n![3](src/screenshots/3.png)\n\n\n\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003ch2\u003e💻 Development\u003c/h2\u003e\u003c/summary\u003e\n\n```bash\nnpm install\nnpm run dev\n```\n\nOpen [http://localhost:3000](http://localhost:3000)\n\n### Build\n\n```bash\nnpm run build\nnpm start\n```\n\n\u003c/details\u003e\n\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003ch2\u003e🗂️ Project Structure\u003c/h2\u003e\u003c/summary\u003e\n\n```\nsrc/\n├── app/                    # Next.js app router\n│   ├── page.tsx            # Main page component\n│   ├── layout.tsx          # Root layout with meta tags\n│   ├── globals.css         # Tailwind styles\n│   ├── error.tsx           # Error boundary\n│   └── favicon.ico         # Site favicon\n├── components/\n│   ├── app/                # App cards \u0026 categories\n│   ├── command/            # Command footer \u0026 AUR settings\n│   ├── common/             # Tooltips, loading states\n│   ├── distro/             # Distribution selector\n│   ├── header/             # Header links \u0026 info\n│   ├── search/             # Search overlay\n│   └── ui/                 # Theme toggle\n├── hooks/                  # React hooks\n│   ├── useLinuxInit.ts     # Main app state management\n│   ├── useKeyboardNavigation.ts\n│   ├── useTheme.tsx\n│   ├── useTooltip.ts\n│   └── useDelayedTooltip.ts\n├── lib/\n│   ├── apps/               # JSON application files by category\n│   ├── data.ts             # Categories, distros, and app unifier\n│   ├── aur.ts              # AUR package detection\n│   ├── analytics.ts        # Umami tracking\n│   ├── utils.ts            # Utility functions\n│   ├── generateInstallScript.ts\n│   └── scripts/            # Per-distro script generators\n└── __tests__/              # Vitest unit tests\n```\n\n\u003c/details\u003e\n\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003ch2\u003e🐳 Docker Deployment\u003c/h2\u003e\u003c/summary\u003e\n\n### Quick Start with Docker\n\n```bash\n# Build the Docker image\ndocker build -t tuxmate:latest .\n\n# Run the container\ndocker run -p 3000:3000 tuxmate:latest\n```\n\n### Using Pre-built Images\n\nPre-built Docker images are automatically published to GitHub Container Registry:\n\n```bash\n# Pull and run the latest image\ndocker pull ghcr.io/abusoww/tuxmate:latest\ndocker run -p 3000:3000 ghcr.io/abusoww/tuxmate:latest\n\n# Or use a specific version\ndocker pull ghcr.io/abusoww/tuxmate:v1.0.0\ndocker run -p 3000:3000 ghcr.io/abusoww/tuxmate:v1.0.0\n```\n\n### Using Docker Compose (Recommended)\n\n```bash\n# Start the application\ndocker-compose up -d\n\n# View logs\ndocker-compose logs -f\n\n# Stop the application\ndocker-compose down\n```\n\nOpen [http://localhost:3000](http://localhost:3000)\n\n### Configuration\n\nThe Docker container exposes port 3000 by default. You can customize the port mapping:\n\n```bash\ndocker run -p 8080:3000 tuxmate:latest\n```\n\n### Environment Variables\n\nThe following environment variables are configured by default:\n\n- `NODE_ENV=production` - Run in production mode\n- `PORT=3000` - Application port\n- `NEXT_TELEMETRY_DISABLED=1` - Disable Next.js anonymous telemetry\n\nYou can override these when running the container:\n\n```bash\ndocker run -p 3000:3000 \\\n  -e PORT=3000 \\\n  -e NEXT_TELEMETRY_DISABLED=1 \\\n  tuxmate:latest\n```\n\n\u003c/details\u003e\n\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003ch2\u003e🛠️ Tech Stack\u003c/h2\u003e\u003c/summary\u003e\n\n- [Next.js](https://nextjs.org/) 16 (App Router)\n- [React](https://react.dev/) 19\n- [TypeScript](https://www.typescriptlang.org/)\n- [Tailwind CSS](https://tailwindcss.com/) 4\n- [Framer Motion](https://www.framer.com/motion/)\n- [GSAP](https://gsap.com/)\n- [Vitest](https://vitest.dev/) (testing)\n- [Lucide React](https://lucide.dev/) (icons)\n\n\u003c/details\u003e\n\n### ⌨️ Keyboard Shortcuts\n\n| Key | Action |\n|-----|--------|\n| `↑` `↓` `←` `→` / `h` `j` `k` `l` | Navigate apps |\n| `Space` | Toggle app selection |\n| `Esc` | Clear focus |\n| `/` | Focus search |\n| `y` | Copy command |\n| `d` | Download script |\n| `t` | Toggle theme |\n| `c` | Clear all selections |\n| `Tab` | Toggle preview drawer |\n\n## 🤝 Contribution\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines.\n\n\n\n## 🎯 Roadmap\n\n### Completed\n- [x] Multi-distro support (Ubuntu, Debian, Arch, Fedora, openSUSE)\n- [x] Nix, Flatpak \u0026 Snap universal package support\n- [x] 180+ applications across 15 categories\n- [x] Smart script generation with error handling\n- [x] Dark / Light theme toggle with smooth animations\n- [x] Copy command \u0026 Download script\n- [x] Custom domain\n- [x] Docker support\n- [x] CI/CD shortcuts \u0026 workflow\n- [x] Search \u0026 filter applications (Real-time)\n- [x] AUR Helper selection (yay/paru) + Auto-detection\n- [x] Keyboard navigation (Vim keys, Arrows, Space, Esc, Enter)\n- [x] Package availability indicators (including AUR badges)\n- [x] Homebrew support (macOS + Linux)\n- [x] PWA support for offline use\n- [x] Nix configuration.nix download with unfree package detection\n\n\n\n\n### Planned\n\n- [ ] Winget support (Windows)\n- [ ] Custom presets / profiles\n- [ ] Share configurations via URL\n- [ ] More distros (FreeBSD, Gentoo, Void, Alpine)\n- [ ] i18n / Multi-language support\n- [ ] Companion CLI tool\n- [ ] Expand application catalog (200+)\n- [ ] Dotfiles integration\n- [ ] Declarative NixOS options support (programs.*) [Issue #36]\n\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003ch4\u003e🔗 Related Projects\u003c/h4\u003e\u003c/summary\u003e\n\t\n- **[LinuxToys](https://github.com/psygreg/linuxtoys)** – User-friendly collection of tools for Linux with an intuitive interface\n- **[Nixite](https://github.com/aspizu/nixite)** – Generates bash scripts to install Linux software, inspired by Ninite\n- **[tuxmate-cli](https://github.com/Gururagavendra/tuxmate-cli)** – CLI companion for tuxmate, uses tuxmate's package database\n\n\u003c/details\u003e\n\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003ch4\u003e💳 Monetary Contributions\u003c/h4\u003e\u003c/summary\u003e\n\nNo tips jar here. I’m happy just knowing you’re using Linux.\n\nIf you want to earn some real life karma points, consider donating to the following organizations:\n\n* [KDE e.V.](https://kde.org/community/donations/)\n* [Gnome Foundation](https://www.gnome.org/donate/)\n* [Arch Linux](https://archlinux.org/donate/)\n* [The Tor Project](https://donate.torproject.org/)\n\nComments, suggestions, bug reports and contributions are welcome.\n\n\u003c/details\u003e\n\n\n\u003cdiv align=\"right\"\u003e\n\n## 📜 License\nLicensed under the [GPL-3.0 License](LICENSE) \u003cbr\u003e\nFree software — you can redistribute and modify it under the terms of the GNU General Public License.\n\n\u003cp align=\"center\"\u003e\n\t\u003cimg src=\"https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/footers/gray0_ctp_on_line.svg?sanitize=true\" /\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabusoww%2Ftuxmate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fabusoww%2Ftuxmate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabusoww%2Ftuxmate/lists"}