v3.0 - Bug fix + new Opening filtered decks

🐛 Fix: Chessboard now fits perfectly on all screen sizes!

Problem: On AnkiDroid, when users increased their system font size, the chessboard would become oversized and get clipped on the left side of the screen. #8

Solution:

• Cleaned up the board's layout to prevent it from sticking to the left.
• Implemented a smart "fit-to-screen" function that automatically shrinks the board if it's too large.
• Used zoom for scaling, which is more reliable on Android than transform.
• Ensured the board is always perfectly centered.

Result: The board now dynamically adjusts to stay fully visible and centered, regardless of your system font settings. No more cutoff pieces! ✨

---

✨ New Feature: Ready-to-use filtered decks for openings!

What's new: The opening pack now includes pre-built filtered decks for common opening types (e.g., Caro Kann, Scotch Game, etc.).

Why it's useful:

• 🎯 Focus your practice on specific openings instantly.
• 📚 Great for targeted study sessions or drilling a particular line.
• 🛠️ These decks are fully customizable—feel free to tweak them to match your needs or add new ones!

How to get started: Simply select the filtered deck you want to study from the deck list and jump right in!

---

New donation section

What’s new: I added a new donation section. Check it out on the README

---

🚀 Update your deck

Please follow the installations instructions to update your current deck :

Step 2: Import with Anki
Go to File → Import
Select the apkg file
Choose "Update existing deck" when prompted and choose whether you want to import schedules
You are ready! ✅

or

Step 4: Update an Existing Deck (Optional)
If you already have the deck and want to update it:
Go to File → CrowdAnki: Import from disk
Select the updated deck folder
Choose "Update existing deck" when prompted
Your progress will be preserved while new cards are added! ✅

v2.0 - Opening Feature

🏰 Chess Opening Deck Generator & Analyzer

Let’s introduce the Chess Opening Deck Generator & Analyzer - the perfect companion to tactical puzzle decks! This powerful new module allows you to create, analyze, and optimize your personalized opening repertoire directly with your json repertoire.

📊 In-Depth Opening Analysis

The analyzer generates professional-quality reports that show you exactly where your opening knowledge stands. Here's a sample of what you'll see:
Opening Report made with the opening json file

════════════════════════════════════════════════════════════════════════════════

    🏰  CHESS OPENING ANALYSIS & REPORTING SUITE (COARS) - VERSION 2.0

    Advanced chess opening deck analysis with interactive visualization
    and personalized recommendations

    Analyzed file: chess_openings.csv
    Analysis date: 2025-10-03 21:11:35

════════════════════════════════════════════════════════════════════════════════

📊 DECK GLOBAL OVERVIEW
────────────────────────────────────────────────────────────────────────────────
 • Total positions: 125
 • Color distribution: White 72 (57.6%) | Black 53 (42.4%)

 • Balance level: [██████████░░░░░░░░░░] 64.8%
 • Theoretical completeness: [████████░░░░░░░░░░] 80.0%
 • Opening diversity: [█████████░░░░░░░░░] 90.0%
 • Theoretical soundness: [██████████████░░░░] 95.2%

♔ WHITE OPENINGS ANALYSIS
────────────────────────────────────────────────────────────────────────────────
Metric          Count  Percentage
──────────────:  ─────:  ─────────:
Total positions     72     100.0%
Mainlines           65      90.3%
Variants             7       9.7%
Families covered     7

Top Families      Count  Percentage
────────────────  ─────  ──────────
🍝 Italian Game     22       30.6%
👑 Queen's Gambit   18       25.0%
🌶️ Spanish Game     15       20.8%
☂️ London System     9       12.5%
🎩 English Opening   6        8.3%

♚ BLACK DEFENSES ANALYSIS
────────────────────────────────────────────────────────────────────────────────
Metric          Count  Percentage
──────────────:  ─────:  ─────────:
Total positions     53     100.0%
Mainlines           48      90.6%
Variants             5       9.4%
Families covered     5

Top Families      Count  Percentage
────────────────  ─────  ──────────
🐉 Sicilian Defense  21       39.6%
🍷 French Defence    15       28.3%
🧘 Indian Defence    10       18.9%
❄️ Scandinavian       4        7.5%
🐗 Caro-Kann          3        5.7%

🔍 Key Features That Set Us Apart

🌐 Comprehensive Opening Coverage

• 500+ opening variations across 15+ major families
• Color-balanced training with separate analysis for white openings and black defenses
• Mainline vs. variant ratio to ensure theoretical soundness

📈 Advanced Metrics & Visualization

• Star-based coverage evaluation for each opening family
• Interactive ASCII board previews of critical positions
• Balance meters showing white/black distribution at a glance
• Depth distribution analysis to identify superficial coverage

💡 Personalized Learning Path

• Targeted recommendations based on your specific gaps
• Progression goals tailored to your current level
• Critical position identification for focused study
• Thematic analysis to strengthen specific aspects of your repertoire

🚀 Getting Started with Opening Decks

Creating your personalized opening deck is incredibly simple:

1. Prepare your opening repertoire in JSON format (use our comprehensive template)
2. Run the generator with just 3 lines of code:

generator = OpeningDeckGenerator()
generator.add_from_popular_openings(your_openings_data)
generator.generate_csv('my_openings.csv')

Ready to master your openings? The same scientific principles that power the tactical deck now extend to opening preparation! Combine both for complete chess mastery from move 1 to checkmate. 🏆♟️

v1.0 - First release

Full Changelog: https://github.com/SKOHscripts/Optimized-Chess-Puzzles/commits/v1.0

First release of Optimized Chess Puzzles 🎯♟️✨

The deck is available in the following languages: French, German, Spanish, Italian, Portuguese, Dutch, Russian, Chinese, Japanese, Polish, Turkish, and English.

🚀 Installation

First method

Step 1: Install CrowdAnki Plugin

1. Open Anki and go to Tools → Add-ons
2. Click Get Add-ons... and enter this code: 1788670778 CrowdAnki
3. Click OK and restart Anki
4. The CrowdAnki plugin is now installed! 🎉

Step 2: Download the Optimized Chess Puzzles Pack

1. Visit the repository: https://github.com/SKOHscripts/Optimized-Chess-Puzzles
2. In the Releases section, download the ZIP archive.
3. Extract the ZIP file to your computer
4. Locate the deck folder containing the JSON file and media folder

Step 3: Import with CrowdAnki

1. Open Anki and go to File → CrowdAnki: Import from disk
2. Browse to the extracted deck folder (containing the .json file)
3. Select the folder and click OK
4. CrowdAnki will import the deck with all media files 📚

Second method

1. In the Releases section, download the apkg file and import it directly to Anki.

🎯 Ready to Train!

The deck is now available in your Anki collection, organized by ELO ranges with optimized spaced repetition intervals. Each card includes:

• FEN Position: Real position to analyze (after preprocessing)
• Moves_SAN: Move sequence in readable notation
• Tactical themes and opening tags to display
• Unified Tags: Merged themes + openings for easy filtering
• Direct links to Lichess and Chess.com for deeper analysis
• Metadata: Rating, popularity for progress tracking
• Diplay theme used for the card (available themes are theme-solarized, theme-paper-sand and nothing for default theme)

This project thus transforms a raw database of millions of puzzles into custom training sets, optimized for systematic progression and lasting memorization of tactical patterns essential at each level! 🚀♟️

---

🎁 Usage & Training Tips

Personal Error Collection 📝

The deck includes a special section for errors and traps encountered in your games. After analyzing your games:

1. Identify critical positions where you made mistakes
2. Click "Share FEN position" on your analysis platform
3. Create a new card with the position and correct moves
4. Add context and use specific tags for easy review

Thematic Training 🎨

Use Anki's filtering system to focus on specific weaknesses:

• Filter by tactical themes (fork, pin, skewer, etc.)
• Filter by opening systems (Sicilian, French, etc.)
• Create custom study sessions based on your needs

---

📊 Statistics

• Based on: Lichess community database
• Optimization: Spaced repetition algorithms
• Coverage: >98% thematic coverage per ELO range
• Quality: 90%+ community approval rating
• Volume: ~1200 puzzles per ELO range