Creating a Desktop Pet with Python and PyQt5: Materials, Implementation Code, and Packaging Guide

1. Desktop‑Pet Assets

The pet’s animations are built from multiple GIF files; you should collect several white‑background GIFs and can obtain them via Premiere Pro export, Photoshop frame animation, or simply download existing GIFs from the web.

2. Python Implementation

2.1 Project Structure

The main script is main.py . Supporting folders contain normal/ GIFs for idle actions, click/ GIFs for click actions, a tigerIcon.jpg for the system tray, and a dialog.txt file with dialogue lines.

2.2 Core Code

Import required modules:

<code>import os
import sys
import random
from PyQt5.QtGui import *
from PyQt5.QtCore import *
from PyQt5.QtWidgets import *</code>

Define the DesktopPet widget, initialize the window (frameless, always‑on‑top, transparent), load GIFs with QMovie , set up the system tray, and start timers for random actions and dialogue.

Key methods include:

init() – configure window flags and transparency.

initPall() – create the tray icon and its menu (Show / Quit).

initPetImage() – load static GIFs and dialogue.

randomPosition() – place the pet at a random screen location.

petNormalAction() – use QTimer to trigger randomAct() and talk() every few seconds.

randomAct() – switch between idle GIFs or the click GIF.

talk() – display a random line from dialog.txt with styled text.

Mouse event handlers ( mousePressEvent , mouseMoveEvent , mouseReleaseEvent ) enable dragging the pet and change its state on click.

enterEvent – change the cursor to a closed hand when hovering.

contextMenuEvent – provide a right‑click menu to hide or quit the pet.

Application entry point:

<code>if __name__ == '__main__':
    app = QApplication(sys.argv)
    pet = DesktopPet()
    sys.exit(app.exec_())</code>

3. Packaging the Application

Install PyInstaller:

<code>pip install pyinstaller</code>

Run the following command in the project directory to create a single‑file, window‑less executable:

<code>pyinstaller -F -w main.py</code>

The resulting main.exe appears in the dist folder; moving it to the project root may be required for proper resource loading.

4. Summary and References

The tutorial concludes with a brief personal note and provides links to additional Python learning resources, a Baidu Cloud folder containing the full project, and several related articles for further exploration.