🐱 Cat Translator (猫咪翻译器)
A Bio-Acoustic Translation System for Feline-Human Communication. 👤 Author
Yang Su
Institution: École Normale Supérieure - PSL
Contact: yang.su@ens.fr
GitHub: @yangsssu
📄 License
This project is licensed under the MIT License.
📖 Introduction (项目介绍)
Cat Translator is a desktop application designed to bridge the communication gap between humans and cats. Using advanced web audio API technologies and frequency analysis, this application listens to your cat's vocalizations in real-time and translates them into human language.
本应用是一个基于生物声学分析的桌面软件，旨在打破人猫交流的障碍。利用先进的 Web Audio API 技术和频谱分析，实时监听猫咪的声音并将其翻译成人类语言。
Whether your cat is purring, meowing, hissing, or chirping, the Feline Interface will decode the bio-acoustic signals and display the likely meaning behind the sound.
✨ Features (功能特性)
Real-time Audio Analysis: Visualizes sound waves and detects dominant frequencies instantly.
实时音频分析：可视化声波并即时检测主频率。
Smart Recognition: Distinguishes between 4 core cat sounds:
Meow (喵): Standard communication.
Purr (呼噜): Healing vibration and contentment.
Chirp (咔咔): Excitement or hunting instinct.
Hiss (哈气): Warning and defense.
Multi-Language Support: Translations available in 7 languages:
🇺🇸 English
🇨🇳 Chinese (中文)
🇯🇵 Japanese (日本語)
🇰🇷 Korean (한국어)
🇫🇷 French (Français)
🇮🇹 Italian (Italiano)
🇩🇪 German (Deutsch)
Immersive UI: A sci-fi, dark-themed interface with dynamic visual feedback.
📥 How to Install (For Users / 用户安装指南)
If you just want to use the app, you don't need to write any code. 如果你只是想使用这个软件，无需编写任何代码。
Download: Go to the [suspicious link removed] page of this repository.
前往本仓库的 Releases 页面。
Get the Installer: Download the file named 猫语翻译器 Setup 1.0.0.exe (or Cat Translator Setup).
下载安装包文件。
Install: Double-click the .exe file. The application will install and automatically launch.
双击运行 .exe 文件，软件将自动安装并启动。
Run: You can open it anytime from the desktop shortcut.
以后可以通过桌面快捷方式随时打开。
🎮 How to Use (使用说明)
Launch the App: Open 猫语翻译器 (Cat Translator).
Initiate System: Click the large Power Button in the center of the screen to activate the audio sensors.
点击屏幕中央的电源按钮启动系统。
Grant Permission: If prompted, allow the application to access your microphone.
如果提示权限请求，请允许访问麦克风。
Select Language: Click the globe icon 🌐 in the top right corner to switch to your preferred language (e.g., Chinese, English).
点击右上角的地球图标切换语言。
Start Listening: Bring the device close to your cat. When your cat makes a sound, the system will analyze the frequency and display the translation on the screen.
将设备靠近猫咪。当猫咪发出声音时，系统会自动分析并显示翻译结果。
🛠️ Build from Source (开发者构建指南)
If you want to modify the code or build the .exe yourself:
Prerequisites
Node.js (v16 or higher)
Git
Installation Steps
Clone the repository
git clone https://github.com/yangsssu/Cat-translator.git cd Cat-translator
Install Dependencies
npm install
Run in Development Mode
npm run electron
Build .exe Installer
npm run electron:build
The installer will be generated in the dist-electron folder. 生成的可执行文件位于 dist-electron 目录中。