lemmoaeen GitHub avatar

Stefanie-Desktop-Pet

lemmoaeen

Stefanie is a Windows desktop pet with sprite animations, a built-in local music player, and interactive controls such as click, drag, resize, and a hover playback overlay.

Stars

5

7-day growth

No data

Forks

0

Open issues

0

License

No data

Last updated

2026-07-31

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It combines a polished WPF desktop pet with a complete local-music playback workflow, including album-sequential playback, an auto-themed control overlay, and privacy-conscious offline operation.

Who it is for

  • Windows users who enjoy desktop pets
  • Fans of Stefanie Sun wanting an interactive desktop character
  • WPF/.NET developers interested in custom pet UIs
  • Users who want a no-cloud local music player companion

Use cases

  • Keep a desktop companion that plays local songs by album
  • Use the pet as a quick music controller via right-click menus or hover overlay
  • Run a portable desktop pet without external image assets
  • Modify and rebuild the WPF app using build.ps1

Strengths

  • Installer and portable EXE are both provided; sprites are embedded and require no external files at runtime
  • Local playback supports sequential songs within the current album and does not collect data or require network access
  • Rich interactions include click lyrics, drag running, wheel resize, right-click menus, and a hover playback overlay
  • Position, size, always-on-top, and autostart settings are saved automatically

Considerations

  • Windows-only and depends on .NET Framework/WPF
  • The 68 lyric lines and the music library must be supplied by the user locally
  • Only one instance can run at a time

README quick start

Stefanie 桌宠

推荐双击 dist/Stefanie-Setup.exe 安装。安装后程序位于当前用户的 %LOCALAPPDATA%\Stefanie 固定目录,并创建桌面与开始菜单快捷方式。

dist/Stefanie.exe 仍可作为便携版本直接运行。

操作

  • 左键点击:从用户提供的 68 句歌词中随机显示一条,同时保持约 3.6 秒的闭眼、闭嘴静止画面;不切换嘴型,也不附加其他动作反馈。
  • 左键拖动:角色播放跑动动画并自动朝向拖动方向;采用 DPI 感知的抓取点锁定,拖动时鼠标不会与角色分离。
  • 鼠标滚轮:连续调整大小。
  • 右键:选择预设大小、切换始终置顶、开关开机自启动或退出程序。
  • 右键“歌曲 · 孙燕姿”:悬停选择专辑,再选择歌曲。歌曲播放完毕后按顺序播放当前专辑的下一首,不会跨到其他专辑。
  • 右键“播放控制”:暂停或继续、上一首、下一首、停止播放。
  • 鼠标在角色身上持续悬停 0.6 秒,会在角色下方显示播放控制浮层。浮层采用深色横向渐变卡片布局,包含当前歌曲、左右时间、可拖动进度条,以及随机、上一首、播放/暂停、下一首、停止和静音图标。主播放键为自适应强调色的胶囊椭圆;所有图标使用无系统蓝色悬停背景的扁平模板。进度条已播放部分为亮白色、未播放部分为灰色,拖动点为小白圆钮。程序会从角色精灵中自动提取主色,为面板渐变和主播放按钮生成配色。尺寸会随角色同步缩放;鼠标进入面板后,一旦离开面板便立即隐藏。

播放器没有独立窗口,音乐来自本地。播放器内部音量固定为 100%,实际响度跟随 Windows 系统音量和系统音量混合器。

程序只允许一个实例运行。重复启动时不会创建第二只桌宠,而会激活已经运行的窗口。 位置、大小、置顶和自启动状态会自动保存。

卸载

可以从 Windows“已安装的应用”中卸载“Stefanie 桌宠”,也可以运行安装目录中的 Uninstall.exe。卸载会清理程序、快捷方式、自启动项和保存的设置。

歌词气泡、字体和边框会随桌宠大小同步缩放;气泡还会根据歌词字数自动改变宽高,保证完整显示。背景由顶部淡粉色向下渐变为白色。待机动作每隔 8–21 秒随机触发一次,并依次使用精灵图中的 11 组动作。两次待机动作之间,角色会使用原精灵表的睁眼—闭眼过渡帧,每隔约 2.8–3.6 秒自然眨眼一次。

歌词气泡可以再次点击。程序会按照气泡标注的歌曲名在本地音乐库中查找并立即播放对应歌曲,后续仍只在该歌曲所在专辑内播放。

角色精灵图已嵌入 EXE,运行时不依赖外部图片。项目使用 Windows 自带的 .NET Framework/WPF,不联网、不收集数据。

重新构建

如需修改源代码,在 Windows PowerShell 中运行:

.\build.ps1

Description

A Windows singer desktop pet with sprite animation, lyric bubbles, and local album playback.

Related repositories

Similar projects matched by category, topics, and programming language.

NUber-dev
Featured
NUber-dev GitHub avatar

YTubic

YTubic is a fast, responsive, open-source YouTube Music desktop client for Windows, Linux, and macOS that uses direct InnerTube API communication and aggressive caching to provide instant navigation and playback.

Web DevelopmentFrontend Frameworks
226
Krishnagangwal
Featured
Krishnagangwal GitHub avatar

CS-Fundamentals

A curated collection of Computer Science fundamentals (PDFs, notes, cheatsheets, interview question banks) for placement preparation, covering seven core subjects plus general resources.

Data & DatabasesDatabases & Storage
2,326
Blaizzy
Featured
Blaizzy GitHub avatar

nativ

Nativ is a native macOS app that lets you run AI models locally on Apple silicon, offering chat, model management, performance analytics, and an OpenAI/Anthropic-compatible API server.

AI & Machine LearningAI Vision & Audio
985