7059b44f69
Discord bot that translates Vivi's emoji communication into text so her community understands her instantly.
3.7 KiB
3.7 KiB
Vivi Speech Translator
What This Is
A Discord bot that translates Vivi's emoji-based communication into text so her community understands what she's saying without prior knowledge. Works with PluralKit/Tupperbox to detect Vivi's messages, learns emoji meanings over time, and can be adopted by other plural systems with mute members who use emojis to communicate.
Core Value
Vivi posts emojis and others instantly understand her without needing to know what each emoji means.
Requirements
Validated
(None yet — ship to validate)
Active
- Bot detects Vivi's messages via PluralKit/Tupperbox integration
- Bot translates emoji sequences into natural language
- Bot learns new emoji meanings when taught (by Vivi or other alters)
- Bot can update/correct existing emoji meanings
- Translation mode can toggle between automatic and on-demand
- Unknown emojis are shown with meanings for known emojis only
- Bot works in Discord channels and DMs
- Emoji meanings are global across all servers
- Bot works in any Discord server without per-server installation friction
- Translation format adapts based on emoji sequences (natural language where possible)
Out of Scope
- Real-time learning from context (emoji meanings learned explicitly, not inferred)
- Voice/speech synthesis (text translation only)
- Mobile app (Discord bot only)
- Moderation or safety features beyond Discord's built-in tools
- Support for non-emoji communication methods (focus on emoji first)
Context
About Vivi:
- Vivi is mute and communicates through custom emoji sequences
- Vivi has Dysgraphia (writing difficulty), making emoji communication more accessible than text
- Vivi can read normally, so she understands text translations
- Vivi is one alter in a plural system; other alters can speak and help manage emoji meanings
Emoji Language:
- Emojis are compositional and read left-to-right, but meanings vary based on sequence
- Includes both standard emojis (😷, ❌) and custom server emojis (
:me1:) - Example:
:me1:😷 2️⃣ 🍑 ❌ 🤧= "Vivi is sick, but not in the sinuses"
Integration:
- Must integrate with PluralKit or Tupperbox to detect when Vivi is the active communicator
- These bots proxy messages through a shared account, but Vivi should be recognizable
Broader Vision:
- Initially built for Vivi's community
- Designed to be generalizable so other plural systems with mute members can adopt it
- Global emoji dictionary allows different systems to maintain their own emoji meanings
Constraints
- Platform: Discord bot only (no web, mobile, or other platforms)
- Integration: Must work seamlessly with PluralKit or Tupperbox
- Accessibility: Must be low-friction for Vivi and other alters to teach/update emoji meanings
- Multi-server: Should work in any Discord server without requiring complex per-server setup
- Global scope: Emoji meanings are global, not per-server (but per-server overrides could be added later)
Key Decisions
| Decision | Rationale | Outcome |
|---|---|---|
| Global emoji dictionary | Vivi's emoji language is consistent across communities; other systems will benefit from shared knowledge | — Pending |
| Learning-based system | Vivi uses many emojis; manual mapping would be unsustainable. Bot learns when taught. | — Pending |
| Auto + on-demand modes | Auto is natural but can be noisy; on-demand is explicit but requires action. Both options respect server preferences. | — Pending |
| PluralKit/Tupperbox integration | These are standard plural system tools; integrating with them lets us detect Vivi's messages accurately | — Pending |
Last updated: 2026-01-29 after initialization