Anki 2048 - Gamified Spaced Repetition

Transform your Anki review sessions into an engaging 2048-style puzzle game! This add-on combines the addictive gameplay of 2048 with the proven effectiveness of spaced repetition learning.

🎮 How It Works

• Card-Based Tiles: Each tile represents Anki cards from your selected deck

• Interval-Based Difficulty: Tiles are categorized by card review intervals:

  • Tile 2: New cards (0 days)
  • Tile 4: 1-2 day intervals
  • Tile 8: 3-6 day intervals
  • Tile 16: 7-14 day intervals
  • Tile 32: 15-30 day intervals
  • And so on up to Tile 2048: 961+ day intervals

• Merge to Review: When you merge two tiles, you review the combined cards in a filtered deck

• Success = Progress: Successfully answering all cards completes the merge and increases your score

• Failure = Rollback: Any "Again" answer cancels the merge and returns the board to its previous state

✨ Key Features

🎯 Smart Card Management

• Single cards per tile by default (multi-card tiles only created through merging)
• Automatic card shuffling after failed reviews to prevent repetitive studying
• Progressive difficulty adjustment: more aggressive shuffling after consecutive failures
• Includes new cards, learning cards, and review cards

🎲 Enhanced Gameplay

• Multi-merge optimization: Review all cards from complex chain reactions in one session
• Persistent board state and high score tracking
• Deck selection with child deck support
• Real-time card availability tracking

🔧 Developer Tools

• Built-in debug console for troubleshooting
• Comprehensive logging system
• Flexible card bucketing system

🚀 Getting Started

1. Install the add-on from AnkiWeb
2. Go to Tools → Play Anki 2048
3. Select a deck containing cards you want to review
4. Use arrow keys to play - merge tiles by reviewing their cards!
5. Try to reach the 2048 tile while maintaining your Anki review schedule

🎯 Perfect For

• Students who want to gamify their study sessions
• Language learners working through vocabulary decks
• Anyone looking to make Anki reviews more engaging
• Users with large card collections who want variety in their reviews

⚙️ System Requirements

• Anki Version: 2.1.50+ (tested up to 2.1.66)
• Platform: Windows, macOS, Linux
• Python: 3.8+ (bundled with Anki)

🔧 Compatibility

• PyQt5/PyQt6: Automatically detects and adapts to your Anki version
• Anki API: Uses modern scheduler and deck management APIs with fallbacks
• Deck Types: Works with all deck types including filtered decks as source material

🎮 Gameplay Tips

• Start with decks containing new cards for easier initial tiles
• Failed reviews shuffle cards automatically - don't get stuck on difficult cards!
• Use the "Refresh Cards" button if you run out of available cards
• Check the debug console if you encounter any issues

📝 Privacy & Data

• No data collection or external connections
• All processing happens locally within Anki
• Board state and high scores stored in Anki's add-on configuration

🐛 Support

If you encounter issues, use the built-in debug console (Tools → Anki 2048: Debug Console) to gather diagnostic information.

📋 Technical Details

File Structure

anki2048/
├── __init__.py          # Entry point and menu integration
├── game_window.py       # Main game UI and logic
├── integrations.py      # Anki deck/card integration
├── review.py           # Review session management
├── util.py             # Configuration utilities
├── debug.py            # Debug console
├── manifest.json       # Add-on metadata
└── README.md           # This file

Card Tier Mapping

TIER_RANGES = {
    2: (0, 0),        # New cards (type=0 or type=1 with ivl=0)
    4: (1, 2),        # 1-2 days
    8: (3, 6),        # 3-6 days  
    16: (7, 14),      # 7-14 days (1-2 weeks)
    32: (15, 30),     # 15-30 days (2 weeks - 1 month)
    64: (31, 60),     # 31-60 days (1-2 months)
    128: (61, 120),   # 61-120 days (2-4 months)
    256: (121, 240),  # 121-240 days (4-8 months)
    512: (241, 480),  # 241-480 days (8-16 months)
    1024: (481, 960), # 481-960 days (16 months - 2.6 years)
    2048: (961, 3840), # 961-3840 days (2.6-10.5 years)
}

🔄 Version History

v1.0.1 (August 2025)

• Fix: Deck ordering on newer Anki versions. Updated deck listing to use deck.id/deck.name from all_names_and_ids() to ensure consistent order.
• Fix: Board layout spacing on some Qt6 systems. The grid now uses fixed tile size and uniform gaps (centered board) to prevent uneven column widths.

v1.0.0 (August 2025)

• Initial release
• Core 2048 gameplay with Anki integration
• Support for new cards, learning cards, and review cards
• Single-card tiles by default
• Multi-merge optimization
• Automatic card shuffling after failures
• Progressive difficulty adjustment
• Debug console and comprehensive logging

Version: 1.0.1
Last Updated: August 2025
License: Open Source

Turn your daily Anki reviews into an exciting puzzle adventure! 🎯🎮