mirror of
https://github.com/abusoww/tuxmate.git
synced 2026-04-18 00:03:23 +02:00
266 lines
7.6 KiB
Markdown
266 lines
7.6 KiB
Markdown
<!-- markdownlint-disable MD041 -->
|
||
|
||
<div align="center">
|
||
<h1><a href="https://tuxmate.abusov.com/"><img alt="TuxMate" src="TUXMATE.png" width=600/></a></h1>
|
||
|
||
|
||
|
||
|
||
[](https://github.com/abusoww/tuxmate/issues)
|
||
[](https://github.com/abusoww/tuxmate/stargazers)
|
||
[](https://github.com/abusoww/tuxmate/blob/main/LICENSE)
|
||
|
||
</div>
|
||
|
||
## 🐧 The only Mate you need for setup
|
||
|
||
**TuxMate** is a web-based Linux application installer that generates
|
||
distro-specific shell scripts, that aims to be the simplest way to bulk-install
|
||
applications on a fresh Linux system.
|
||
|
||
Maybe you've just installed a fresh Linux distro. Perhaps you're setting up
|
||
a new machine or can't remember all the package names for your favorite apps?
|
||
|
||
|
||
## 📦 Supported Distributions
|
||
|
||
- Ubuntu / Debian (apt)
|
||
- Arch Linux (pacman + AUR)
|
||
- Fedora (dnf)
|
||
- openSUSE (zypper)
|
||
- Nix (nix-env)
|
||
- Flatpak
|
||
- Snap
|
||
|
||
## ✨ Features 🌟
|
||
|
||
### **Application Catalog**
|
||
150+ applications across 15 categories: browsers, communication, dev tools, terminals, media, creative software, gaming, office, VPN/network, security, and more.
|
||
|
||
### **Smart Script Generation**
|
||
- Detects already-installed packages
|
||
- Handles AUR packages automatically on Arch
|
||
- Enables RPM Fusion when needed on Fedora
|
||
- Parallel installation for Flatpak
|
||
- Network retry with exponential backoff
|
||
- Progress bars with ETA
|
||
- Colored output and summary reports
|
||
|
||
### **Availability Awareness**
|
||
Shows which apps are available for your selected distro, with instructions for unavailable packages.
|
||
|
||
|
||
|
||
|
||
## 📸 Screenshots
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<details>
|
||
<summary><h2>💻 Development</h2></summary>
|
||
|
||
```bash
|
||
npm install
|
||
npm run dev
|
||
```
|
||
|
||
Open [http://localhost:3000](http://localhost:3000)
|
||
|
||
### Build
|
||
|
||
```bash
|
||
npm run build
|
||
npm start
|
||
```
|
||
|
||
</details>
|
||
|
||
|
||
<details>
|
||
<summary><h2>🗂️ Project Structure</h2></summary>
|
||
|
||
```
|
||
src/
|
||
├── app/ # Next.js app router
|
||
│ ├── page.tsx # Main page component
|
||
│ ├── layout.tsx # Root layout with meta tags
|
||
│ └── globals.css # Tailwind styles
|
||
├── components/
|
||
│ ├── app/ # App cards & categories
|
||
│ ├── command/ # Command footer & AUR bar
|
||
│ ├── common/ # Tooltips, loading states
|
||
│ ├── distro/ # Distribution selector
|
||
│ ├── header/ # Header & theme toggle
|
||
│ └── ui/ # Base UI components
|
||
├── hooks/ # React hooks
|
||
│ ├── useLinuxInit.ts # Main app state management
|
||
│ ├── useKeyboardNavigation.ts
|
||
│ ├── useTheme.ts
|
||
│ └── useDelayedTooltip.ts
|
||
├── lib/
|
||
│ ├── data.ts # Apps, distros, icons
|
||
│ ├── aur.ts # AUR package detection
|
||
│ ├── analytics.ts # Umami tracking
|
||
│ ├── generateInstallScript.ts
|
||
│ └── scripts/ # Per-distro script generators
|
||
└── __tests__/ # Vitest unit tests
|
||
```
|
||
|
||
</details>
|
||
|
||
|
||
<details>
|
||
<summary><h2>🐳 Docker Deployment</h2></summary>
|
||
|
||
### Quick Start with Docker
|
||
|
||
```bash
|
||
# Build the Docker image
|
||
docker build -t tuxmate:latest .
|
||
|
||
# Run the container
|
||
docker run -p 3000:3000 tuxmate:latest
|
||
```
|
||
|
||
### Using Pre-built Images
|
||
|
||
Pre-built Docker images are automatically published to GitHub Container Registry:
|
||
|
||
```bash
|
||
# Pull and run the latest image
|
||
docker pull ghcr.io/abusoww/tuxmate:latest
|
||
docker run -p 3000:3000 ghcr.io/abusoww/tuxmate:latest
|
||
|
||
# Or use a specific version
|
||
docker pull ghcr.io/abusoww/tuxmate:v1.0.0
|
||
docker run -p 3000:3000 ghcr.io/abusoww/tuxmate:v1.0.0
|
||
```
|
||
|
||
### Using Docker Compose (Recommended)
|
||
|
||
```bash
|
||
# Start the application
|
||
docker-compose up -d
|
||
|
||
# View logs
|
||
docker-compose logs -f
|
||
|
||
# Stop the application
|
||
docker-compose down
|
||
```
|
||
|
||
Open [http://localhost:3000](http://localhost:3000)
|
||
|
||
### Configuration
|
||
|
||
The Docker container exposes port 3000 by default. You can customize the port mapping:
|
||
|
||
```bash
|
||
docker run -p 8080:3000 tuxmate:latest
|
||
```
|
||
|
||
### Environment Variables
|
||
|
||
The following environment variables are configured by default:
|
||
|
||
- `NODE_ENV=production` - Run in production mode
|
||
- `PORT=3000` - Application port
|
||
- `NEXT_TELEMETRY_DISABLED=1` - Disable Next.js anonymous telemetry
|
||
|
||
You can override these when running the container:
|
||
|
||
```bash
|
||
docker run -p 3000:3000 \
|
||
-e PORT=3000 \
|
||
-e NEXT_TELEMETRY_DISABLED=1 \
|
||
tuxmate:latest
|
||
```
|
||
|
||
</details>
|
||
|
||
|
||
## 🛠️ Tech Stack
|
||
|
||
- [Next.js](https://nextjs.org/) 16 (App Router)
|
||
- [React](https://react.dev/) 19
|
||
- [TypeScript](https://www.typescriptlang.org/)
|
||
- [Tailwind CSS](https://tailwindcss.com/) 4
|
||
- [Framer Motion](https://www.framer.com/motion/)
|
||
- [GSAP](https://gsap.com/)
|
||
- [Vitest](https://vitest.dev/) (testing)
|
||
- [Lucide React](https://lucide.dev/) (icons)
|
||
|
||
|
||
## 🚀 Usage
|
||
you can use the Arrow Keys or `h` `j` `k` `l` to navigate, `Enter` to select, `Esc` to go back, `Space` to toggle selection.
|
||
1. Select your distribution from the dropdown
|
||
2. Browse categories and select applications
|
||
3. Copy the generated command or download the full install script
|
||
4. Run the script on your Linux machine
|
||
|
||
## 🤝 Contribution
|
||
|
||
See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines.
|
||
|
||
|
||
|
||
## 🎯 Roadmap
|
||
|
||
### Completed
|
||
- [x] Multi-distro support (Ubuntu, Debian, Arch, Fedora, openSUSE)
|
||
- [x] Nix, Flatpak & Snap universal package support
|
||
- [x] 150+ applications across 15 categories
|
||
- [x] Smart script generation with error handling
|
||
- [x] Dark / Light theme toggle with smooth animations
|
||
- [x] Copy command & Download script
|
||
- [x] Custom domain
|
||
- [x] Docker support
|
||
- [x] CI/CD shortcuts & workflow
|
||
- [x] Search & filter applications (Real-time)
|
||
- [x] AUR Helper selection (yay/paru) + Auto-detection
|
||
- [x] Keyboard navigation (Vim keys, Arrows, Space, Esc, Enter)
|
||
- [x] Package availability indicators (including AUR badges)
|
||
|
||
|
||
|
||
|
||
### Planned
|
||
|
||
- [ ] Winget support (Windows)
|
||
- [ ] Homebrew support (macOS)
|
||
- [ ] Save custom presets / profiles
|
||
- [ ] Share configurations via URL
|
||
- [ ] More distros (Gentoo, Void, Alpine)
|
||
- [ ] PWA support for offline use
|
||
- [ ] Companion CLI tool
|
||
- [ ] Expand application catalog (200+)
|
||
- [ ] Dotfiles integration
|
||
|
||
<details>
|
||
<<<<<<< HEAD
|
||
<summary><h4>🔗 Related Projects</h4></summary>
|
||
=======
|
||
<summary><h2>🔗 Related Projects</h2></summary>
|
||
>>>>>>> 0cbf41e (fix: add move zellij from terminal to cli tools)
|
||
|
||
- **[LinuxToys](https://github.com/psygreg/linuxtoys)** – User-friendly collection of tools for Linux with an intuitive interface
|
||
- **[Nixite](https://github.com/aspizu/nixite)** – Generates bash scripts to install Linux software, inspired by Ninite
|
||
- **[tuxmate-cli](https://github.com/Gururagavendra/tuxmate-cli)** – CLI companion for tuxmate, uses tuxmate's package database
|
||
|
||
</details>
|
||
|
||
<div align="right">
|
||
|
||
## 📜 License
|
||
Licensed under the [GPL-3.0 License](LICENSE) <br>
|
||
Free software — you can redistribute and modify it under the terms of the GNU General Public License.
|
||
|
||
<p align="center">
|
||
<img src="https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/footers/gray0_ctp_on_line.svg?sanitize=true" />
|
||
</p>
|