tuxagotchi

terpinedreamGPL-3.0长期未更新

一款终端里的企鹅宠物养成工具，通过把代码推送到 GitHub 来「喂食」Tux，用游戏化方式督促你持续跟进自己的项目。

CLI application that encourages you to keep up with your projects. "Feed" tux in your terminal by pushing your code to github.

暂无版本209star7fork同步于 2026-11-07 07:33 UTC

终端宠物游戏化 Git 推送生产力待办督促

对比 GitHub 官网 archlinux cava git linux productivity

怎么上手

由 README 提炼，执行前请确认

原文

git clone https://github.com/terpinedream/tuxagotchi.git
cd tuxagotchi
pip install -r requirements.txt
python3 -m textual_app.app

硬件要求按 README 说明

README 未说明；音频可视化需要本机安装 Cava，非 Linux 用户需改用 no-cava 分支

下载：源码 zip·GitHub Releases（安装包）本站不镜像安装包

项目说明

由 README 自动翻译提炼

没人工点评？写下你的经验

终端养企鹅的 CLI 小工具，靠往 GitHub 推代码来喂它，帮你盯住项目进度

一款终端里的企鹅宠物养成工具，通过把代码推送到 GitHub 来「喂食」Tux，用游戏化方式督促你持续跟进自己的项目。

核心能力

用 ASCII 渲染 Tux 头像，随 GitHub 提交历史切换情绪动画
按提交活跃度分开心、一般、难过三种情绪，每种两帧动画
显示倒计时，提示 Tux 下次变饿的时间
内置支持 vim 按键的交互式 TODO 列表
集成 Cava 做实时音频可视化，底部有按键提示栏

容易踩的坑

运行前必须在根目录手写 config.toml，填 GitHub 用户名、仓库名和 token；音频可视化依赖外部 Cava，Debian/Ubuntu 需先 apt install cava；非 Linux 用户要从 no-cava 分支克隆，否则会有冲突

内容由模型根据 README 生成，可能不完整或不准确，以官方文档为准。看原文 README

用户点评

登录用户的真实使用记录，可按版本和硬件筛选

共 0 条

还没有人点评。第一个说出真实体验的人最有价值。

README 原文

未翻译

在 GitHub 打开

Tuxagotchi (Textual Edition)

Tuxagotchi is a terminal-based companion that thrives on your GitHub activity.
This version is a full refactor using Textual, providing a responsive and animated terminal UI featuring a commit-based mood system, interactive TODO list, and a real-time audio visualizer powered by Cava.

Screenshot

Features

ASCII-rendered Tux avatar that reacts to your GitHub commit history and displays animated emotional states
Mood-based animation system using 6 ASCII frames (2 per mood: happy, neutral, sad)
Countdown timer indicating when Tux will become hungry again
Interactive TODO list with vim motions
Real-time audio visualizer integration using Cava
Customizable and modular architecture using Textual's widget system
Keybind hint bar at the bottom for user guidance

Installation

Arch Linux Users: Install with yay

yay -S tuxagotchi

Other | please note: non-linux users should clone from the 'no-cava' branch to avoid conflicts

Clone the repository:

git clone https://github.com/terpinedream/tuxagotchi.git
cd tuxagotchi

Install Python dependencies:
```
pip install -r requirements.txt
```
Install external dependencies:
- Cava is required for the audio visualizer:
  - Arch Linux:
```
sudo pacman -S cava
```
  - Debian/Ubuntu:
```
sudo apt install cava
```
  - Or build from source

Create a config.toml file in the root directory with the following structure:

[github]
username = "your-github-username"
repo = "your-repo-name"
token = "your-repo-token"

Running the Application

AUR Package

tuxagotchi

From Source

python3 -m textual_app.app

WORKING ON INTEGRATION WITH SPOTIFY CAR THING

Author

Maintained by @terpinedream