RecordTheseHands v2.3.12

Android Application

• Unchanged. Version number remains at v2.3.11

Server

• Added must_not_have_prompts_file to the register_login endpoint to prevent creating a login for a user that already has a prompts file.
• Improved logging.
• Added the ability to turn a login_token into a login_hash to token_maker.py.

RecordTheseHands v2.3.11

Release Notes - v2.3.11

Android Application

Technical Changes

• Device ID Generation: Implemented a more robust, unambiguous hex generator
  for internal device IDs.
• Admin Interface: Hidden advanced settings (Device ID configuration,
  "Dismiss Circle" toggle) by default. They can be revealed by tapping the
  "Admin Interface" title 5 times.
• Server Communication: The app now securely reports the ANDROID_ID to the
  server during login.

Server

Improvements

• Device Tracking:
  • The /register_login endpoint now stores the android_id and maintains a
    history of logins per device in a new all/{device_id} sub-collection.
  • The /directives endpoint now logs the requesting device_id in the user's
    heartbeat data.

RecordTheseHands v2.3.10

Release Notes - v2.3.10

Server

New Features & Tools

• Statistics Generation: Added a new stats command to
  create_directive.py that generates comprehensive user statistics from data
  dumps.
• Tutorial Prompt Merging: Updated apply_instructions_to_prompts.py to
  support merging tutorial prompts from a separate JSON file.

Bug Fixes

• Login: Fixed a flask-login issue in home_page that would make users
  unable to log in if they had an invalid remember_token.
• Version Check: Fixed a bug so that the server side version check now
  correctly thinks v2.3.9 < v2.3.10.

Refactoring & Cleanup

• Code Cleanup: Removed several deprecated scripts (dump_clips.py,
  phrases_to_prompts.py, upload_file.py, upload_mixed_prompts.py).
• Lint: Addressed all lint warnings in python scripts.

RecordTheseHands v2.3.9

Release Notes - v2.3.9

Server

Bug Fixes

• Save Endpoint Fix: Corrected a variable reference error in the /save
  endpoint that prevented prompt progress from being correctly updated.
• Updated App version: The Android versionCode and versionName for the app
  hadn't been updated since v1.3.1 .

Note to self, maybe test things before releasing them.

RecordTheseHands v2.3.8

Release Notes - v2.3.8

Android Application

Technical Changes

• Enhanced Data Persistence: Improved DataManager with thread-safe
  singleton initialization and locking for user settings and application status
  updates.
• State Management: Refactored AppStatus and UserSettings retrieval to
  ensure reliable JSON parsing and consistent state synchronization with the
  persistent store.

Server

New Features & User Interface

• Video Review Enhancements: The /video page now includes a "Show Clips"
  toggle, allowing administrators to preview individual clips directly in the
  browser with "Go to start/end" controls, or generate ffplay commands for
  local playback.
• User Management Dashboard: Improved the /users page with color-coded
  heartbeat indicators (green for recent, blue for hours, purple for days, red
  for longer) to quickly assess user activity.
• Registration Access: Added a direct "Register" link to the login page for
  easier account creation.
• Progress Tracking: Bug fix: The /save endpoint now tracks the maximum
  prompt index reached in each section, storing it in heartbeat/max_prompt for
  better progress monitoring.

Developer Tools

• Database Management: Added new commands to create_directive.py
  (userData, saveDatabase, restoreUser, deleteUser) for backing up,
  restoring, and deleting user data, utilizing concurrent execution for
  performance.
• Cleanup: Removed the deprecated upload_apk.py script.
• Documentation: Added technical summaries for both the Android app and
  Python server to README.md.

Refactoring

• Code Quality: Applied linting and improved docstrings across main.py and
  create_directive.py.

RecordTheseHands v2.3.7

Release Notes - v2.3.7

New Features

• Enhanced Security for Device Association: Implemented strict device ID
  checks during account attachment. The server now verifies if the requesting
  device matches the device ID previously associated with the username.
• Admin Override for Device ID: Added a "Remove previous device" option in
  the Admin Interface. This allows administrators to explicitly override the
  device ID mismatch error and associate a new device with an existing username.

UI/UX Improvements

• Accessibility: Added content descriptions to video player controls
  (Expand, Restart, Pause, Play) for better accessibility support.
• String Externalization: Extracted numerous hardcoded UI strings (Admin
  interface labels, progress counters, error messages) into strings.xml for
  better maintainability and localization support.
• Progress Formatting: Improved the formatting of prompt progress indicators
  (e.g., "1 of 10", "50%").

Technical Changes

• State Management Refactoring: Separated overviewInstructionsShown state
  into a new AppStatus class, distinct from UserSettings, to better
  categorize application state versus user preferences.
• Robust Parsing: Added error handling for PromptType parsing to default
  to TEXT if an unknown type is encountered.

RecordTheseHands v2.3.6

Android Application (2.3.6)

New Features & User Interface

• Overview Instructions: Introduced a new global "Overview Instructions" feature that can appear automatically for new users.
  • Added an "Overview" button to the main Prompt Selection screen to review these instructions at any time.
  • Instructions can now include an interactive Example Prompt in addition to text and video.
• Admin Controls: Added a "Reset Overview Instructions" button in the Admin settings to allow clearing the "viewed" status of instructions for testing or re-onboarding.
• Tablet Support: Improved layout constraints for the Prompt Selection screen on tablet devices.

Improvements & Internal Changes

• User Settings Storage: Migrated user preferences (like enableDismissCountdownCircle and the new overviewInstructionsShown) to a JSON-based storage format for better extensibility.
• Data Parsing: Refactored PromptsCollection, PromptsSection, and Prompt parsing logic into dedicated fromJson factory methods.
• Resource Management: Updated the resource downloader to ensure assets for overview instructions and example prompts are properly cached.
• Dependencies: Added kotlin-parcelize plugin and updated the Android Gradle Plugin to 8.13.1.

Server (v2.3.6)

New Tools

• Instruction Management: Added apply_instructions_to_prompts.py, a utility script to merge instruction data (including global overview and section-specific instructions) into prompt JSON files.

RecordTheseHands v2.3.5

App works with Phone and Tablet. Test run with D-PAN for Open Ended Prompts Data Collection.

RecordTheseHands v2.3.3

Draft Release for Open Ended Prompts Data Collection.

Works with both Phone and Tablet. Extensive refactoring to have all activities use Jetpack Compose and significant UI modifications to support Phone use.

An instructions page now allows for video and/or text instructions for each prompt section.

RecordTheseHands v2.3.2

Initial troubleshooting release for use with D-PAN. Tablet only.