tpkg - Teto Package Manager

1. What is tpkg?

tpkg (Teto Package Manager) is a modern package management system built natively in Rust for tetoOS and Windows.

If you've ever used Arch Linux (pacman) or Void Linux (xbps), you'll feel right at home. Instead of opening a web browser, hunting down download buttons, dodging installer adware, and clicking "Next, Next, Agree, Finish", tpkg lets you install, update, and manage all your software with single, concise terminal commands.

2. Beginner Quick Start

You don't need to memorize dozens of flags. Here are the 3 most essential commands you'll use 95% of the time:

tpkg -Sw Discord.Discord Valve.Steam Spotify.Spotify

tpkg -Syu

For daily computer use, pairing tpkg with the vast Winget and Microsoft Store ecosystem is the easiest and most powerful method to get your software!

You get the ultra-clean CLI experience of tpkg combined with immediate access to hundreds of thousands of popular Windows games, browsers, chat tools, and developer utilities (e.g. Google Chrome, Visual Studio Code, Discord, Steam, OBS Studio).

Popular One-Liner Install Bundles:

tpkg -Sw Valve.Steam Discord.Discord OBSProject.OBSStudio Spotify.Spotify

tpkg -Sw Microsoft.VisualStudioCode Git.Git 7zip.7zip Python.Python.3.12

4. Installing & Upgrading Native Packages (-S / Sync)

The -S (Sync) mode interacts with official tetoOS repositories to download, verify, install, and update native .tetopkg packages.

Example Terminal Output:

$ tpkg -S neovim
 
:: Resolving dependencies...
Packages (3) libuv-1.46.0  luajit-2.1.0  neovim-0.10.0
 
Total Download Size:   8.43 MiB
Total Installed Size:  32.10 MiB
 
:: Proceed with installation? [Y/n] y
:: Downloading packages...
 libuv-1.46.0              [############################] 100%
 luajit-2.1.0              [############################] 100%
 neovim-0.10.0             [############################] 100%
:: Verifying checksums... done
:: Installing packages...
(1/3) installing libuv                   [############################] done
(2/3) installing luajit                  [############################] done
(3/3) installing neovim                  [############################] done

5. Searching & Inspecting (-Q / Query)

The -Q (Query) mode lets you inspect your local system to see what is currently installed, search local apps, and trace files.

6. Uninstalling Software Cleanly (-R / Remove)

When you remove software with tpkg, it tracks installed files precisely to prevent leaving orphaned junk or bloated directories behind.

Managing Repositories via -R:

You can also configure custom package repositories using repo flags:

# List all active package repositories
tpkg -R --list-repo
 
# Add a third-party or internal community repository
tpkg -R --add-repo https://repo.example.com/teto
 
# Remove a repository by name
tpkg -R --remove-repo custom-repo

7. Community Repository (TETAUR)

TETAUR (Teto User Repository) is the community repository system, inspired directly by Arch Linux's AUR.

While the main tpkg repository contains officially verified packages, TETAUR allows developers and power users to share build recipes (TETOBUILD) for game patches, custom themes, and nightly development builds.

8. Building Packages (-B / TETOBUILD)

Building packages in tpkg is straightforward. Instead of complex bash scripts, recipes use clean, human-readable TOML format.

Sample TETOBUILD.toml:

[meta]
pkgname = "sample-tool"
pkgver  = "1.0.0"
pkgrel  = 1
pkgdesc = "Ultra fast sample CLI utility"
arch    = ["x86_64"]
license = ["MIT"]
 
[deps]
depends = ["curl"]
 
[[source]]
url    = "https://example.com/downloads/v1.0.0.zip"
sha256 = "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
 
[scripts]
package = """
copy sample-tool.exe ${pkgdir}\bin\
"""

Build Commands:

9. Quick Command Cheat Sheet

Bookmark or save this cheat sheet for fast reference whenever you're using the terminal: