0.2.18

- Fix sound effect volume wiring and apply volume to all effects (hit/miss/correct/incorrect)
- Respect "Enable music" and "Volume" when playing congratulations music and when resuming background music (uses selected track)
- Add "Enable Sound Effects" checkbox (on by default) and honor it across the app
- Save generated effects to `assets/audio/effects/` so they are picked up by the app
- Add `requests` dependency for sound effect generation

README.md

@@ -9,10 +9,10 @@ python_version: 3.12.8
 app_port: 8501
 app_file: app.py
 tags:
-  - game
-  - vocabulary
-  - streamlit
-  - education
+ - game
+ - vocabulary
+ - streamlit
+ - education
 ---
 
 # BattleWords
@@ -23,7 +23,7 @@ BattleWords is a vocabulary learning game inspired by classic Battleship mechani
 
 ## Features
 
-- 12x12 grid with six hidden words (2x4-letter, 2x5-letter, 2x6-letter)
+-12x12 grid with six hidden words (2x4-letter,2x5-letter,2x6-letter)
 - Words placed horizontally or vertically
 - Radar visualization to help locate word boundaries
 - Reveal grid cells and guess words for points
@@ -41,19 +41,19 @@ BattleWords is a vocabulary learning game inspired by classic Battleship mechani
 
 ## Installation
 1. Clone the repository:
-   ```
-   git clone https://github.com/Oncorporation/BattleWords.git
-    cd battlewords
-   ```
-   2. (Optional) Create and activate a virtual environment:
-    ```
-    python -m venv venv
-    source venv/bin/activate  # On Windows use `venv\Scripts\activate`
-    ```
+ ```
+ git clone https://github.com/Oncorporation/BattleWords.git
+ cd battlewords
+ ```
+2. (Optional) Create and activate a virtual environment:
+ ```
+ python -m venv venv
+ source venv/bin/activate # On Windows use `venv\Scripts\activate`
+ ```
 3. Install dependencies: ( add --system if not using a virutal environment)
-    ```
-    uv pip install -r requirements.txt --link-mode=copy 
-    ```
+ ```
+ uv pip install -r requirements.txt --link-mode=copy 
+ ```
 
 
 ## Running BattleWords
@@ -81,20 +81,20 @@ To deploy on Hugging Face Spaces:
 For local Docker runs:
 ```sh
 docker build -t battlewords .
-docker run -p 8501:8501 battlewords
+docker run -p8501:8501 battlewords
 ```
 
 ## Folder Structure
 
 - `app.py` – Streamlit entry point
 - `battlewords/` – Python package
-  - `models.py` – data models and types
-  - `word_loader.py` – word list loading and validation
-  - `generator.py` – word placement logic
-  - `logic.py` – game mechanics (reveal, guess, scoring)
-  - `ui.py` – Streamlit UI composition
-  - `storage.py` – **NEW**: persistent storage and high scores
-  - `words/wordlist.txt` – candidate words
+ - `models.py` – data models and types
+ - `word_loader.py` – word list loading and validation
+ - `generator.py` – word placement logic
+ - `logic.py` – game mechanics (reveal, guess, scoring)
+ - `ui.py` – Streamlit UI composition
+ - `storage.py` – **NEW**: persistent storage and high scores
+ - `words/wordlist.txt` – candidate words
 - `specs/` – documentation (`specs.md`, `requirements.md`)
 - `tests/` – unit tests
 
@@ -107,116 +107,128 @@ docker run -p 8501:8501 battlewords
 
 ## Changelog
 
+### v0.3.0 (planned)
+ - Game Sharing: share unique game URLs with friends to challenge them on the same word set.
+ - High Scores: local leaderboard tracking top scores by wordlist and game mode.
+ - Persistent Storage: all game results saved locally for personal statistics without accounts.
+
+-0.2.18
+ - Fix sound effect volume wiring and apply volume to all effects (hit/miss/correct/incorrect)
+ - Respect "Enable music" and "Volume" when playing congratulations music and when resuming background music (uses selected track)
+ - Add "Enable Sound Effects" checkbox (on by default) and honor it across the app
+ - Save generated effects to `assets/audio/effects/` so they are picked up by the app
+ - Add `requests` dependency for sound effect generation
+ 
 -0.2.17
-  - documentation updates and corrections
-  - updated CLAUDE.md with accurate feature status and project structure
-  - clarified v0.3.0 planned features vs current implementation
+ - documentation updates and corrections
+ - updated CLAUDE.md with accurate feature status and project structure
+ - clarified v0.3.0 planned features vs current implementation
 
 -0.2.16
-  - replace question marks in score panel with underscores
-  - add option to toggle incorrect guess history display in settings (enabled by default)
-  - game over popup updated to ensure it is fully visible on screen
-  
+ - replace question marks in score panel with underscores
+ - add option to toggle incorrect guess history display in settings (enabled by default)
+ - game over popup updated to ensure it is fully visible on screen
+ 
 -0.2.15
-  - fix music playing after game end
-  - change incorrect guesses icon
-  - fix sound effect and music volume issues
-  
+ - fix music playing after game end
+ - change incorrect guesses icon
+ - fix sound effect and music volume issues
+ 
 -0.2.14
-  - bug fix on final score popup
-  - score panel alignment centered
-  - change incorrect guess history UI
+ - bug fix on final score popup
+ - score panel alignment centered
+ - change incorrect guess history UI
 
 -0.2.13
-  - upgrade background ocean view 
-  - apply volume control to sound effects
+ - upgrade background ocean view 
+ - apply volume control to sound effects
 
 -0.2.12
-  - fix music looping on congratulations screen
+ - fix music looping on congratulations screen
 
 -0.2.11
-  - update timer to be live during gameplay, but reset with each action
-  - compact design
-  - remove fullscreen image tooltip
+ - update timer to be live during gameplay, but reset with each action
+ - compact design
+ - remove fullscreen image tooltip
 
 -0.2.10
-  - reduce sonar graphic size
-  - update music and special effects file locations
-  - remove some music and sound effects
-  - change Guess Text input color
-  - incorrect guess UI update
-  - scoreboard update
+ - reduce sonar graphic size
+ - update music and special effects file locations
+ - remove some music and sound effects
+ - change Guess Text input color
+ - incorrect guess UI update
+ - scoreboard update
 
 -0.2.9
-  - fix sonar grid alignment issue on some browsers
-  - When all letters of a word are revealed, it is automatically marked as found.
+ - fix sonar grid alignment issue on some browsers
+ - When all letters of a word are revealed, it is automatically marked as found.
 
 -0.2.8
-  - Add 10 incorrect guess limit per game
+ - Add10 incorrect guess limit per game
 
 -0.2.7
-  - fix background music playback issue on some browsers
-  - add sound effects
-  - enhance sonar grid visualization
-  - add claude.md documentation
-  
+ - fix background music playback issue on some browsers
+ - add sound effects
+ - enhance sonar grid visualization
+ - add claude.md documentation
+ 
 -0.2.6
-  - fix sonar grid alignment
-  - improve score summary layout and styling
-  - Add timer to game display in sidebar
+ - fix sonar grid alignment
+ - improve score summary layout and styling
+ - Add timer to game display in sidebar
 
-- 0.2.5
-  - fix finale pop up issue
-  - make grid cells square on wider devices
+-0.2.5
+ - fix finale pop up issue
+ - make grid cells square on wider devices
 
-- 0.2.4
-  - Add music files to repo
-  - disable music by default  
+-0.2.4
+ - Add music files to repo
+ - disable music by default 
 
-- 0.2.3
-  - Update version information display
-  - adjust sonar grid alignment
-  - fix settings scroll issue  
-  
-- 0.2.2
-  - Add Musical background and settings to toggle sound on/off.
+-0.2.3
+ - Update version information display
+ - adjust sonar grid alignment
+ - fix settings scroll issue 
+ 
+-0.2.2
+ - Add Musical background and settings to toggle sound on/off.
 
-- 0.2.1
-  - Add Theme toggle (light/dark/custom) in sidebar.
+-0.2.1
+ - Add Theme toggle (light/dark/custom) in sidebar.
 
-- 0.2.0
-  - Added a loading screen when starting a new game.
-  - Added a congratulations screen with your final score and tier when the game ends.
-  
-- 0.1.13 
-  - Improved score summary layout for clarity and style.
+-0.2.0
+ - Added a loading screen when starting a new game.
+ - Added a congratulations screen with your final score and tier when the game ends.
+ 
+-0.1.13 
+ - Improved score summary layout for clarity and style.
 
-- 0.1.12
-  - Improved score summary layout and styling.
-  - Enhanced overall appearance and readability.
+-0.1.12
+ - Improved score summary layout and styling.
+ - Enhanced overall appearance and readability.
 
-- 0.1.11
-  - Game now ends when all words are found or revealed.
-  - Added word spacing logic and improved settings.
+-0.1.11
+ - Game now ends when all words are found or revealed.
+ - Added word spacing logic and improved settings.
 
-- 0.1.10
-  - Added game mode selector and improved UI feedback.
+-0.1.10
+ - Added game mode selector and improved UI feedback.
 
-- 0.1.9
-  - Improved background and mobile layout.
+-0.1.9
+ - Improved background and mobile layout.
 
-- 0.1.8
-  - Updated to Python 3.12.
+-0.1.8
+ - Updated to Python3.12.
 
-- 0.1.5
-  - Added hit/miss indicator and improved grid feedback.
+-0.1.5
+ - Added hit/miss indicator and improved grid feedback.
 
-- 0.1.4
-  - Radar visualization improved and mobile layout enhanced.
+-0.1.4
+ - Radar visualization improved and mobile layout enhanced.
 
-- 0.1.3
-  - Added wordlist picker and sort feature.
-  - Improved score panel and final score display.
+-0.1.3
+ - Added wordlist picker and sort feature.
+ - Improved score panel and final score display.
 
 ## Known Issues / TODO
 
@@ -247,14 +259,14 @@ emoji: 🎲
 colorFrom: blue
 colorTo: indigo
 sdk: streamlit
-sdk_version: 1.25.0
-python_version: 3.10
+sdk_version:1.25.0
+python_version:3.10
 app_file: app.py
 tags:
-  - game
-  - vocabulary
-  - streamlit
-  - education
+ - game
+ - vocabulary
+ - streamlit
+ - education
 ---
 ```
 
@@ -262,17 +274,17 @@ tags:
 - `title`, `emoji`, `colorFrom`, `colorTo`: Visuals for your Space.
 - `sdk`: Use `streamlit` for Streamlit apps.
 - `sdk_version`: Latest supported Streamlit version.
-- `python_version`: Python version (default is 3.10).
+- `python_version`: Python version (default is3.10).
 - `app_file`: Entry point for your app.
 - `tags`: List of descriptive tags.
 
-**Dependencies:**  
+**Dependencies:** 
 Add a `requirements.txt` with your Python dependencies (e.g., `streamlit`, etc.).
 
-**Port:**  
+**Port:** 
 Streamlit Spaces use port `8501` by default.
 
-**Embedding:**  
+**Embedding:** 
 Spaces can be embedded in other sites using an `<iframe>`:
 
 ```html
@@ -298,38 +310,38 @@ To generate and save custom sound effects for BattleWords, you can use the `gene
 
 ```python
 def generate_sound_effect(effect: str, save_to_assets: bool = False, use_api: str = "huggingface") -> str:
-    """
-    Generate a sound effect and save it as a file.
-
-    Parameters:
-    - `effect`: Name of the effect to generate.
-    - `save_to_assets`: If `True`, saves the effect to the assets directory; 
-      if `False`, saves to a temporary location. Default is `False`.
-    - `use_api`: API to use for generation. Options are "huggingface" or "replicate". Default is "huggingface".
-
-    Returns:
-    - File path to the saved sound effect.
-    """
-
-    # ... [sound generation code] ...
-
-    if save_to_assets:
-        # Save to effects directory
-        assets_dir = os.path.join(os.path.dirname(__file__), "assets", "audio", "effects")
-        os.makedirs(assets_dir, exist_ok=True)
-        filename = f"{effect}.wav"
-        path = os.path.join(assets_dir, filename)
-        with open(path, "wb") as f:
-            f.write(audio_bytes)
-        print(f"  Saved to: {path}")
-    else:
-        # Save to temporary file
-        with tempfile.NamedTemporaryFile(suffix=".wav", delete=False) as tmpfile:
-            tmpfile.write(audio_bytes)
-            path = tmpfile.name
-            print(f"  Saved to: {path}")
-
-    return path
+ """
+ Generate a sound effect and save it as a file.
+
+ Parameters:
+ - `effect`: Name of the effect to generate.
+ - `save_to_assets`: If `True`, saves the effect to the assets directory; 
+ if `False`, saves to a temporary location. Default is `False`.
+ - `use_api`: API to use for generation. Options are "huggingface" or "replicate". Default is "huggingface".
+
+ Returns:
+ - File path to the saved sound effect.
+ """
+
+ # ... [sound generation code] ...
+
+ if save_to_assets:
+ # Save to effects directory
+ assets_dir = os.path.join(os.path.dirname(__file__), "assets", "audio", "effects")
+ os.makedirs(assets_dir, exist_ok=True)
+ filename = f"{effect}.wav"
+ path = os.path.join(assets_dir, filename)
+ with open(path, "wb") as f:
+ f.write(audio_bytes)
+ print(f" Saved to: {path}")
+ else:
+ # Save to temporary file
+ with tempfile.NamedTemporaryFile(suffix=".wav", delete=False) as tmpfile:
+ tmpfile.write(audio_bytes)
+ path = tmpfile.name
+ print(f" Saved to: {path}")
+
+ return path
 ```
 
 ## Parameters
@@ -375,7 +387,7 @@ Happy gaming and sound designing!
 ### High Scores 🏆
 - Local high score tracking (stored in `~/.battlewords/data/`)
 - Filter high scores by wordlist and game mode
-- Top 10 leaderboard display
+- Top10 leaderboard display
 - Player names supported (optional)
 
 ### Persistent Storage 💾
@@ -387,13 +399,13 @@ Happy gaming and sound designing!
 
 - `app.py` – Streamlit entry point
 - `battlewords/` – Python package
-  - `models.py` – data models and types
-  - `word_loader.py` – word list loading and validation
-  - `generator.py` – word placement logic
-  - `logic.py` – game mechanics (reveal, guess, scoring)
-  - `ui.py` – Streamlit UI composition
-  - `storage.py` – **NEW**: persistent storage and high scores
-  - `words/wordlist.txt` – candidate words
+ - `models.py` – data models and types
+ - `word_loader.py` – word list loading and validation
+ - `generator.py` – word placement logic
+ - `logic.py` – game mechanics (reveal, guess, scoring)
+ - `ui.py` – Streamlit UI composition
+ - `storage.py` – **NEW**: persistent storage and high scores
+ - `words/wordlist.txt` – candidate words
 - `specs/` – documentation (`specs.md`, `requirements.md`)
 - `tests/` – unit tests
 
@@ -407,7 +419,7 @@ Happy gaming and sound designing!
 
 **Files**:
 - `game_results.json` - All completed games
-- `highscores.json` - Top 100 scores
+- `highscores.json` - Top100 scores
 
 You can delete these files at any time to reset your data.
 

battlewords/__init__.py

@@ -1,2 +1,2 @@
-__version__ = "0.2.17"
+__version__ = "0.2.18"
 __all__ = ["models", "generator", "logic", "ui"]

battlewords/audio.py

@@ -204,6 +204,13 @@ def play_sound_effect(effect_name: str, volume: float = 0.5) -> None:
     """
     from streamlit.components.v1 import html as _html
 
+    # Respect Enable Sound Effects setting from sidebar
+    try:
+        if not st.session_state.get("enable_sound_effects", True):
+            return
+    except Exception:
+        pass
+
     sound_files = get_sound_effect_files()
 
     if effect_name not in sound_files:

battlewords/sounds.py

@@ -47,7 +47,7 @@ def generate_sound_effect(effect: str, save_to_assets: bool = False, use_api: st
 
     Args:
         effect: Name of the effect (must be in EFFECT_PROMPTS)
-        save_to_assets: If True, save to battlewords/assets/audio/ instead of temp directory
+        save_to_assets: If True, save to battlewords/assets/audio/effects/ instead of temp directory
         use_api: API to use - "huggingface" (default) or "replicate"
     """
     if effect not in EFFECT_PROMPTS:
@@ -79,8 +79,8 @@ def generate_sound_effect(effect: str, save_to_assets: bool = False, use_api: st
 
     # Determine save location
     if save_to_assets:
-        # Save to assets directory
-        assets_dir = os.path.join(os.path.dirname(__file__), "assets", "audio")
+        # Save to effects assets directory (preferred by audio.py)
+        assets_dir = os.path.join(os.path.dirname(__file__), "assets", "audio", "effects")
         os.makedirs(assets_dir, exist_ok=True)
         filename = f"{effect}.wav"
         path = os.path.join(assets_dir, filename)
@@ -174,7 +174,7 @@ def generate_all_effects(save_to_assets: bool = True):
     Generate all sound effects defined in EFFECT_PROMPTS.
 
     Args:
-        save_to_assets: If True, save to battlewords/assets/audio/ directory
+        save_to_assets: If True, save to battlewords/assets/audio/effects/ directory
     """
     print(f"\nGenerating {len(EFFECT_PROMPTS)} sound effects...")
     print("=" * 60)

battlewords/ui.py

@@ -108,6 +108,9 @@ ocean_background_css = """
   opacity: 0.10;
   animation: waveOverlayScroll 16s linear infinite;
 }
+.stIFrame {
+    margin-bottom:25px;
+}
 
 @keyframes waveOverlayScroll {
   0%   { background-position:   0px   0px,   0px   0px; }
@@ -230,7 +233,7 @@ def inject_styles() -> None:
             display: flex;
             align-items: center;
             justify-content: center;
-            border: 1px solid #3a3a3a;
+            border: 1px solid #1d64c8;
             border-radius: 0;
             font-weight: 700;
             user-select: none;
@@ -395,34 +398,38 @@ def _init_session() -> None:
 
 
 def _new_game() -> None:
-    selected = st.session_state.get("selected_wordlist")
-    mode = st.session_state.get("game_mode")
-    show_grid_ticks = st.session_state.get("show_grid_ticks", False)
-    spacer = st.session_state.get("spacer", 1)
-    show_incorrect_guesses = st.session_state.get("show_incorrect_guesses", False)
-    # --- Preserve music settings ---
-    music_enabled = st.session_state.get("music_enabled", False)
-    music_track_path = st.session_state.get("music_track_path")
-    music_volume = st.session_state.get("music_volume", 15)
-    st.session_state.clear()
-    if selected:
-        st.session_state.selected_wordlist = selected
-    if mode:
-        st.session_state.game_mode = mode
-    st.session_state.show_grid_ticks = show_grid_ticks
-    st.session_state.spacer = spacer
-    st.session_state.show_incorrect_guesses = show_incorrect_guesses
-    # --- Restore music settings ---
-    st.session_state.music_enabled = music_enabled
-    if music_track_path:
-        st.session_state.music_track_path = music_track_path
-    st.session_state.music_volume = music_volume
-    st.session_state.radar_gif_path = None
-    st.session_state.radar_gif_signature = None
-    st.session_state.start_time = datetime.now()  # Reset timer on new game
-    st.session_state.end_time = None
-    st.session_state.incorrect_guesses = []  # Clear incorrect guesses for new game
-    _init_session()
+ selected = st.session_state.get("selected_wordlist")
+ mode = st.session_state.get("game_mode")
+ show_grid_ticks = st.session_state.get("show_grid_ticks", False)
+ spacer = st.session_state.get("spacer",1)
+ show_incorrect_guesses = st.session_state.get("show_incorrect_guesses", False)
+ # --- Preserve music and effects settings ---
+ music_enabled = st.session_state.get("music_enabled", False)
+ music_track_path = st.session_state.get("music_track_path")
+ music_volume = st.session_state.get("music_volume",15)
+ effects_volume = st.session_state.get("effects_volume",25)
+ enable_sound_effects = st.session_state.get("enable_sound_effects", True)
+ st.session_state.clear()
+ if selected:
+    st.session_state.selected_wordlist = selected
+ if mode:
+    st.session_state.game_mode = mode
+ st.session_state.show_grid_ticks = show_grid_ticks
+ st.session_state.spacer = spacer
+ st.session_state.show_incorrect_guesses = show_incorrect_guesses
+ # --- Restore music/effects settings ---
+ st.session_state.music_enabled = music_enabled
+ if music_track_path:
+    st.session_state.music_track_path = music_track_path
+ st.session_state.music_volume = music_volume
+ st.session_state.effects_volume = effects_volume
+ st.session_state.enable_sound_effects = enable_sound_effects
+ st.session_state.radar_gif_path = None
+ st.session_state.radar_gif_signature = None
+ st.session_state.start_time = datetime.now() # Reset timer on new game
+ st.session_state.end_time = None
+ st.session_state.incorrect_guesses = [] # Clear incorrect guesses for new game
+ _init_session()
 
 
 def _to_state() -> GameState:
@@ -518,7 +525,7 @@ def _render_sidebar():
         st.checkbox("Show Grid ticks", value=st.session_state.show_grid_ticks, key="show_grid_ticks")
         
         # Add Spacer option
-        spacer_options = [0, 1, 2]
+        spacer_options = [0,1,2]
         if "spacer" not in st.session_state:
             st.session_state.spacer = 1
         st.selectbox(
@@ -544,29 +551,33 @@ def _render_sidebar():
             st.session_state.music_volume = 15
         # --- Add sound effects volume ---
         if "effects_volume" not in st.session_state:
-            st.session_state.effects_volume = 50
+            st.session_state.effects_volume = 25
+        # --- Add enable sound effects ---
+        if "enable_sound_effects" not in st.session_state:
+            st.session_state.enable_sound_effects = True
+        st.checkbox("Enable Sound Effects", value=st.session_state.enable_sound_effects, key="enable_sound_effects")
 
         enabled = st.checkbox("Enable music", value=st.session_state.music_enabled, key="music_enabled")
 
         st.slider(
             "Volume",
-            0,
-            100,
-            value=int(st.session_state.music_volume),
-            step=1,
-            key="music_volume",
-            disabled=not (enabled and bool(tracks)),
-        )
+0,
+100,
+ value=int(st.session_state.music_volume),
+ step=1,
+ key="music_volume",
+ disabled=not (enabled and bool(tracks)),
+ )
 
         # --- Add sound effects volume slider ---
         st.slider(
             "Sound Effects Volume",
-            0,
-            100,
-            value=int(st.session_state.effects_volume),
-            step=1,
-            key="effects_volume",
-        )
+0,
+100,
+ value=int(st.session_state.effects_volume),
+ step=1,
+ key="effects_volume",
+ )
 
         selected_path = None
         if tracks:
@@ -1107,12 +1118,12 @@ def _render_guess_form(state: GameState):
             if correct:
                 st.session_state.radar_gif_path = None
                 st.session_state.radar_gif_signature = None
-                play_sound_effect("correct_guess", volume=0.5)
+                play_sound_effect("correct_guess", volume=(st.session_state.get("effects_volume", 50) / 100))
             else:
                 # Update incorrect guesses list - keep only last 10
                 st.session_state.incorrect_guesses.append(guess_text)
                 st.session_state.incorrect_guesses = st.session_state.incorrect_guesses[-10:]
-                play_sound_effect("incorrect_guess", volume=0.5)
+                play_sound_effect("incorrect_guess", volume=(st.session_state.get("effects_volume", 50) / 100))
             st.rerun()
 
 
@@ -1244,13 +1255,13 @@ def _render_score_panel(state: GameState):
 # -------------------- Game Over Dialog --------------------
 
 def _game_over_content(state: GameState) -> None:
-    # Play congratulations music (not sound effect) as background
+    # Play congratulations music (not sound effect) as background if enabled
     music_dir = _get_music_dir()
     congrats_music_path = os.path.join(music_dir, "congratulations.mp3")
-    if os.path.exists(congrats_music_path):
+    if st.session_state.get("music_enabled", False) and os.path.exists(congrats_music_path):
         src_url = _load_audio_data_url(congrats_music_path)
         # Play once (no loop) at configured volume
-        _mount_background_audio(enabled=True,src_data_url=src_url, volume=(st.session_state.get("music_volume", 100)) / 100, loop=False)
+        _mount_background_audio(enabled=True, src_data_url=src_url, volume=(st.session_state.get("music_volume", 100)) / 100, loop=False)
     else:
         _mount_background_audio(False, None, 0.0)
 
@@ -1388,9 +1399,9 @@ def _render_game_over(state: GameState):
     visible = bool(st.session_state.get("show_gameover_overlay", True)) and is_game_over(state)
     music_dir = _get_music_dir()
     if visible:
-        # Mount congratulations music (play once, do not loop)
+        # Mount congratulations music (play once, do not loop) only if music is enabled
         congrats_music_path = os.path.join(music_dir, "congratulations.mp3")
-        if os.path.exists(congrats_music_path):
+        if st.session_state.get("music_enabled", False) and os.path.exists(congrats_music_path):
             src_url = _load_audio_data_url(congrats_music_path)
             _mount_background_audio(enabled=True, src_data_url=src_url, volume=(st.session_state.get("music_volume", 100)) / 100, loop=False)
         else:
@@ -1399,35 +1410,23 @@ def _render_game_over(state: GameState):
     else:
         # Only play background music if music is enabled
         if st.session_state.get("music_enabled", False):
-            background_path = os.path.join(music_dir, "background.mp3")
-            if os.path.exists(background_path):
-                src_url = _load_audio_data_url(background_path)
+            # Prefer user-selected track
+            track_path = st.session_state.get("music_track_path")
+            if track_path and os.path.exists(track_path):
+                src_url = _load_audio_data_url(track_path)
                 _mount_background_audio(True, src_url, (st.session_state.get("music_volume", 100)) / 100)
             else:
-                _mount_background_audio(False, None, 0.0)
+                # Fallback to a default background track if available
+                background_path = os.path.join(music_dir, "background.mp3")
+                if os.path.exists(background_path):
+                    src_url = _load_audio_data_url(background_path)
+                    _mount_background_audio(True, src_url, (st.session_state.get("music_volume", 100)) / 100)
+                else:
+                    _mount_background_audio(False, None, 0.0)
         else:
             # Disable all music playback
             _mount_background_audio(False, None, 0.0)
 
-def _sort_wordlist(filename):    
-    import time  # Add this import
-
-    WORDS_DIR = os.path.join(os.path.dirname(__file__), "words")
-    filepath = os.path.join(WORDS_DIR, filename)
-    sorted_words = sort_word_file(filepath)
-    # Optionally, write sorted words back to file
-    with open(filepath, "w", encoding="utf-8") as f:
-        # Re-add header if needed
-        f.write("# Optional: place a large A–Z word list here (one word per line).\n")
-        f.write("# The app falls back to built-in pools if fewer than 500 words per length are found.\n")
-        for word in sorted_words:
-            f.write(f"{word}\n")
-    # Show a message in Streamlit
-    st.success(f"{filename} sorted by length and alphabetically. Starting new game in 5 seconds...")
-    time.sleep(5)  # 5 second delay before starting new game
-    _new_game()
-
-
 def run_app():
     # Handle overlay dismissal via query params using new API
     try:

pyproject.toml

@@ -1,12 +1,13 @@
 [project]
 name = "battlewords"
-version = "0.1.0"
+version = "0.2.18"
 description = "BattleWords vocabulary game"
 readme = "README.md"
 requires-python = ">=3.12,<3.13"
 dependencies = [
     "streamlit>=1.50.0",
     "matplotlib>=3.8",
+    "requests>=2.31.0",
 ]
 
 [build-system]