{"id":26759511,"url":"https://github.com/l3dw/focus-tv_with_utils","last_synced_at":"2026-05-04T01:36:10.140Z","repository":{"id":284791548,"uuid":"956074586","full_name":"L3DW/Focus-TV_with_Utils","owner":"L3DW","description":"Interactive WebXR experience using React Three Fiber, featuring a dynamic video screen with custom clip selection, real-time subtitles, and 3D controls. Leverages Adobe Premiere Pro for precise timeline markers and subtitle generation. Demonstrates advanced React, Three.js, and multimedia integration techniques.","archived":false,"fork":false,"pushed_at":"2025-03-27T17:25:27.000Z","size":7085,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-27T18:22:49.882Z","etag":null,"topics":["3d-graphics","interactive-experience","multimedia-app","react","react-three-fiber","threejs","video-player","webxr"],"latest_commit_sha":null,"homepage":"https://codesandbox.io/p/github/L3DW/Focus-TV_with_Utils","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/L3DW.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-27T16:51:58.000Z","updated_at":"2025-03-27T17:37:52.000Z","dependencies_parsed_at":"2025-03-27T18:38:22.689Z","dependency_job_id":null,"html_url":"https://github.com/L3DW/Focus-TV_with_Utils","commit_stats":null,"previous_names":["l3dw/focus-tv_with_utils"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/L3DW%2FFocus-TV_with_Utils","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/L3DW%2FFocus-TV_with_Utils/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/L3DW%2FFocus-TV_with_Utils/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/L3DW%2FFocus-TV_with_Utils/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/L3DW","download_url":"https://codeload.github.com/L3DW/Focus-TV_with_Utils/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246068305,"owners_count":20718503,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3d-graphics","interactive-experience","multimedia-app","react","react-three-fiber","threejs","video-player","webxr"],"created_at":"2025-03-28T17:18:44.607Z","updated_at":"2026-05-04T01:36:10.135Z","avatar_url":"https://github.com/L3DW.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎥 Focus-TV with Utilities\n\n## 🌟 Overview\n\nFocus-TV is a WebXR experience built using **React** and **Three.js**, featuring an interactive video screen with dynamic clip selection, real-time subtitles, and custom 3D controls.\n\n---\n\n## 📂 Project Structure\n\n### 🔑 Key Components\n\n1. **🎬 VideoScreen**: A custom React Three Fiber component that manages:\n   - Video playback\n   - Clip selection\n   - Real-time subtitles\n   - Interactive 3D controls\n\n2. **⚙️ Custom Hooks**:\n   - `useClips`: Parses and manages video clip markers.\n   - `useSubtitles`: Handles real-time subtitle rendering.\n   - `useVideoTextureControls`: Provides advanced video control methods.\n\n---\n\n## ✨ Key Features\n\n- 🎥 **Dynamic Clip Selection**: Seamlessly switch between video clips.\n- 📝 **Real-Time Subtitle Tracking**: Subtitles synced with video playback.\n- 🖥️ **3D Interactive Video Screen**: Immersive and interactive controls.\n- 📊 **Performance Monitoring**: Integrated with `r3f-perf` for real-time performance insights.\n\n---\n\n## 🎞️ Workflow with Adobe Premiere Pro\n\n### 📌 Timeline Markers (`clips.csv`)\n\nAdobe Premiere Pro was used to generate precise timeline markers, which are exported to the `clips.csv` file. These markers define:\n\n- 🎥 Clip names\n- ⏱️ Start and end times\n- 📊 Segmentation points for the video\n\n### 📝 Subtitles (`subtitles.csv`)\n\nThe subtitle generation process was streamlined using Adobe Premiere Pro, creating a CSV file with:\n\n- ⏱️ Start times\n- ⏱️ End times\n- 📝 Subtitle text\n- 📚 Layer information\n\n---\n\n## 🛠️ Technical Stack\n\nThe project leverages the following technologies:\n\n- ⚛️ **React 19**: A JavaScript library for building user interfaces.\n- 🎨 **React Three Fiber**: A React renderer for Three.js.\n- 🌌 **Three.js**: A 3D library for rendering and animating 3D graphics.\n- 🖋️ **Zustand**: A small, fast, and scalable state management library.\n- 📊 **r3f-perf**: A performance monitoring tool for React Three Fiber.\n- 🧠 **@react-three/drei**: Useful helpers for React Three Fiber.\n- 🌐 **WebXR**: For immersive AR/VR experiences.\n\n---\n\n## 🚀 Getting Started\n\nFollow these steps to set up and run the project:\n\n1. **Clone the repository**:\n   ```bash\n   git clone https://github.com/your-repo/Focus-TV_with_Utils.git\n   cd Focus-TV_with_Utils\n   ```\n\n2. **Install dependencies**:\n   Ensure you have [Node.js](https://nodejs.org/) installed, then run:\n   ```bash\n   npm install\n   ```\n\n3. **Run the development server**:\n   Start the app locally:\n   ```bash\n   npm start\n   ```\n\n4. **Open the app**:\n   - Navigate to `http://localhost:3000` in your browser.\n\n5. **Build for production** (optional):\n   To create a production build, run:\n   ```bash\n   npm run build\n   ```\n\n---\n\n## ⚡ Performance Optimization\n\n- 🧠 **Memoized Components**: Reduces unnecessary re-renders.\n- 🎥 **Lazy Loading**: Optimized video resource loading.\n- 📊 **Performance Monitoring**: Integrated with `r3f-perf` for real-time insights.\n\n---\n\n## 🙌 Credits\n\nCreated with creativity and precision, leveraging the power of **React Three Fiber** and **Adobe Premiere Pro**.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fl3dw%2Ffocus-tv_with_utils","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fl3dw%2Ffocus-tv_with_utils","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fl3dw%2Ffocus-tv_with_utils/lists"}