minor updates - ffmpeg and readme

Author: Dheeraj791

Core/setup_ffmpeg.py

@@ -30,49 +30,24 @@ def setup_ffmpeg():
     os.makedirs(bin_dir, exist_ok=True)
 
     if system == "Windows":
-        ffmpeg_url = "https://www.gyan.dev/ffmpeg/builds/ffmpeg-release-full.7z"
-        ffmpeg_7z_path = os.path.join(bin_dir, "ffmpeg.7z")
-
-        seven_zip_archive = os.path.join(bin_dir, "7z-extra.7z")
-        seven_zip_exe = os.path.join(bin_dir, "7z.exe")
-
-        if arch == "64bit":
-            seven_zip_url = "https://www.7-zip.org/a/7z2301-extra.7z"
-        else:
-            seven_zip_url = "https://www.7-zip.org/a/7z2107-extra.7z"
-
-        if not os.path.exists(seven_zip_exe):
-            print("Downloading 7z portable binary...")
-            download_file(seven_zip_url, seven_zip_archive)
-
-            print("Please extract 7z.exe manually from:")
-            print(f"  {seven_zip_archive}")
-            print(f"To: {bin_dir}")
-            print("Then rerun this script.")
-            exit(1)
-
-        # Download and extract FFmpeg
-        if not os.path.exists(ffmpeg_7z_path):
-            print("Downloading FFmpeg full .7z...")
-            download_file(ffmpeg_url, ffmpeg_7z_path)
-
-        print("Extracting FFmpeg...")
-        try:
-            subprocess.run([seven_zip_exe, 'x', ffmpeg_7z_path, f'-o{bin_dir}', '-y'], check=True)
-        except subprocess.CalledProcessError as e:
-            print("Error: Failed to extract ffmpeg. Ensure 7z.exe is a valid executable for your system.")
-            raise e
-
-        os.remove(ffmpeg_7z_path)
+        url = "https://github.com/BtbN/FFmpeg-Builds/releases/download/latest/ffmpeg-master-latest-win64-gpl-shared.zip"
+        zip_path = os.path.join(bin_dir, "ffmpeg.zip")
+        download_file(url, zip_path)
+        extract_zip(zip_path, bin_dir)
+        os.remove(zip_path)
 
+        ffmpeg_exe = None
         for root, _, files in os.walk(bin_dir):
             if "ffmpeg.exe" in files:
-                src = os.path.join(root, "ffmpeg.exe")
-                dst = os.path.join(bin_dir, "ffmpeg.exe")
-                shutil.copy(src, dst)
-                print(f"ffmpeg.exe copied to {dst}")
+                ffmpeg_exe = os.path.join(root, "ffmpeg.exe")
                 break
 
+        if not ffmpeg_exe:
+            raise RuntimeError("ffmpeg.exe not found after extracting the zip.")
+
+        shutil.copy(ffmpeg_exe, os.path.join(bin_dir, "ffmpeg.exe"))
+        print(f"ffmpeg.exe copied to: {os.path.join(bin_dir, 'ffmpeg.exe')}")
+
     elif system == "Darwin":
         url = "https://evermeet.cx/ffmpeg/ffmpeg-7.1.1.zip"
         zip_path = os.path.join(bin_dir, "ffmpeg.zip")

README.md

@@ -35,7 +35,7 @@ Our goal is to support earlier diagnosis of MND and related conditions through a
 
 <p align="center">
 <img src="static/images/architecture.png" alt="Product Preview"
-     style="width: 100%; max-width: 1000px; height: auto; border: 4px ridge #ccc;">
+     style="width: 800px; max-width: 1000px; height: 415px; border: 4px ridge #ccc;">
 </p>
 
 
@@ -111,10 +111,22 @@ Follow the steps below to set up and run the Flask application locally:
 
 ## Features
 
-- Single video upload
-- Bulk video upload
-- Live previews
-- Fullscreen mode
+# Single Video Upload
+Upload a single ultrasound video along with its muscle group and probe orientation.
+This feature is designed to support large ultrasound files (GB-scale).
+
+A small 1-2 MB test sample video is included for functionality testing purposes.
+
+# Bulk Video Upload via Excel
+Upload an entire folder of ultrasound videos using select folder functionality, automatically generate an Excel template, fill in details such as muscle group and probe orientation, and submit it for processing.
+This enables batch analysis for high-throughput use cases or larger clinical datasets.
+
+# Live Video Previews & Fasciculation Visualization
+After processing, the application provides live previews of all videos.
+Detected fasciculations are overlaid in real time, and an interactive graph shows their distribution across the video timeline for easy verification and interpretation.
+
+# Fullscreen Viewing Mode
+All processed videos can be expanded to fullscreen, enhancing clarity during analysis and review of subtle fasciculation patterns.
 
 
 

templates/index.html

@@ -162,6 +162,7 @@ <h2>Single Video Upload</h2>
 
                     xhr.open("POST", "/upload", true);
                     xhr.send(formData);
+                    
                 }
 
                 function formatETA(seconds) {
@@ -189,9 +190,8 @@ <h2>Single Video Upload</h2>
                     } else {
                         return `${bytes.toFixed(2)} B`;
                     }
-                }
-
-
+                
+        }
 
             </script>
 
@@ -348,13 +348,17 @@ <h2>Bulk Video Upload</h2>
             }
         };
 
-
     </script>
+    <script>
+        window.addEventListener("pageshow", function (event) {
+          if (event.persisted || performance.getEntriesByType("navigation")[0].type === "back_forward") {
+            window.location.reload();
+          }
+        });
+    </script>
+
     <script src="{{ url_for('static', filename='js/config.js') }}"></script>
     <script src="{{ url_for('static', filename='js/alert.js') }}"></script>
 
-
-
 </body>
-
 </html>

tests/sample_data/README.md

@@ -1 +1,43 @@
 
+## Testing with Sample Excel File
+
+This project includes a utility function that generates a test Excel file with the correct absolute paths to sample video files, helping automate testing.
+
+### How It Works
+
+- The function `get_test_excel_with_correct_paths()` loads a provided Excel template (`test_data_template.xlsx`) containing placeholder paths.
+- It replaces the placeholder `"__VIDEO_PATH__"` with the actual absolute path to the sample video file (`test_video.mp4`).
+- The updated Excel file is saved as `test_data_generated.xlsx` in the `sample_data` folder.
+- This generated Excel file can be used directly for testing the application without manual path edits.
+
+### Manual Testing Instructions
+
+If you want to test the application manually using sample files:
+
+1. Open the Excel template `test_data_template.xlsx` located in the `sample_data` folder.
+2. Replace the placeholder paths (e.g., `"__VIDEO_PATH__"`) with the **absolute paths** to your sample video files on your system.
+3. Save the Excel file (under a new name if preferred).
+4. Provide this edited Excel file to the application as the test input.
+
+This way, the application will correctly locate and process your sample videos during manual testing.
+
+
+### Note
+
+All test cases and performance validations were executed on a high-specification machine equipped with:
+
+
+64-bit Windows 11
+
+Intel Core i7 processor
+
+32 GB RAM
+
+SSD storage
+
+Python 3.10+
+
+The application was tested with both small test videos (~1 MB) and large real-world ultrasound files (up to several GBs).
+All functionalities — including single and bulk video uploads, Excel integration, real-time previews, and fasciculation detection — were successfully verified and passed across all scenarios.
+
+If any test case fails due to a timeout or resource limit, please retry the operation.