{"id":13651356,"url":"https://github.com/iNavFlight/blackbox-log-viewer","last_synced_at":"2025-04-22T22:31:14.353Z","repository":{"id":42535646,"uuid":"64051286","full_name":"iNavFlight/blackbox-log-viewer","owner":"iNavFlight","description":"Interactive log viewer for flight logs recorded with blackbox","archived":false,"fork":false,"pushed_at":"2024-08-24T13:31:14.000Z","size":9288,"stargazers_count":37,"open_issues_count":13,"forks_count":28,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-09T14:02:39.164Z","etag":null,"topics":["blackbox","hacktoberfest","inav"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/iNavFlight.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2016-07-24T06:03:24.000Z","updated_at":"2025-02-22T15:38:42.000Z","dependencies_parsed_at":"2022-08-12T10:01:38.380Z","dependency_job_id":"67753132-13e4-4828-b267-35ce3133b278","html_url":"https://github.com/iNavFlight/blackbox-log-viewer","commit_stats":null,"previous_names":[],"tags_count":41,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iNavFlight%2Fblackbox-log-viewer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iNavFlight%2Fblackbox-log-viewer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iNavFlight%2Fblackbox-log-viewer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iNavFlight%2Fblackbox-log-viewer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iNavFlight","download_url":"https://codeload.github.com/iNavFlight/blackbox-log-viewer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250333930,"owners_count":21413480,"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":["blackbox","hacktoberfest","inav"],"created_at":"2024-08-02T02:00:48.502Z","updated_at":"2025-04-22T22:31:12.989Z","avatar_url":"https://github.com/iNavFlight.png","language":"JavaScript","funding_links":[],"categories":["Telemetry \u0026 Logs 📊"],"sub_categories":["Modules 🧩"],"readme":"# INAV Blackbox Explorer\n\n![Main explorer interface](screenshots/main-interface.jpg)\n\nThis tool allows you to open logs recorded by INAV's Blackbox feature in your web browser. You can seek through\nthe log to examine graphed values at each timestep. If you have a flight video, you can load that in as well and it'll\nbe played behind the log. You can export the graphs as a WebM video to share with others.\n\n## Installation\n\n_INAV Blackbox Explorer_ is distributed as _standalone_ application.\n\n### Windows\n\n1. Visit [release page](https://github.com/iNavFlight/blackbox-log-viewer/releases)\n1. Download app for Windows platform (win32 or win64 if present)\n1. Extract ZIP archive\n1. Run app from unpacked folder\n1. App is not signed, so you have to allow Windows to run untrusted application. There might be a monit for it during first run \n\n### Mac\n\n1. Visit [release page](https://github.com/iNavFlight/blackbox-log-viewer/releases)\n1. Download app for Mac platform\n1. Extract ZIP archive\n1. Run application\n1. App is not signed, so you have to allow Mac to run untrusted application. There might be a monit for it during first run \n\n## Usage\nClick the \"Open log file/video\" button at the top right and select your logged \".TXT\" file and your flight video (if \nyou recorded one).\n\nYou can scroll through the log by clicking or dragging on the seek bar that appears underneath the main graph. The \ncurrent time is represented by the vertical red bar in the center of the graph. You can also click and drag left and\nright on the graph area to scrub backwards and forwards.\n\n### Syncing your log to your flight video\n\nThe blackbox plays a short beep on the buzzer when arming, and this corresponds with the start of the logged data.\nYou can sync your log against your flight video by pressing the \"start log here\" button when you hear the beep in the\nvideo. You can tune the alignment of the log manually by pressing the nudge left and nudge right buttons in the log\nsync section, or by editing the value in the \"log sync\" box. Positive values move the log toward the end of the video, \nnegative values move it towards the beginning.\n\n### Customizing the graph display\n\nClick the \"Graph Setup\" button on the right side of the display in order to choose which fields should be plotted on\nthe graph. You may, for example, want to remove the default gyro plot and add separate gyro plots for each rotation axis.\nOr you may want to plot vbat against throttle to examine your battery's performance.\n\n## Native app build via NW.js\n\n### Development\n\n1. Install node.js\n2. Change to project folder and run `npm install`.\n3. Run `npm start` to start.\n3. Run `npm debug` to build \u0026 run the debug flavor (optional).\n\n### App build and release\n\nThe tasks are defined in `gulpfile.js` and can be run either via `gulp \u003ctask-name\u003e` (if the command is in PATH or via `../node_modules/gulp/bin/gulp.js \u003ctask-name\u003e`:\n\n1. Optional, install gulp `npm install --global gulp-cli`.\n2. Run `gulp \u003ctaskname\u003e [[platform] [platform] ...]`.\n\nList of possible values of `\u003ctask-name\u003e`:\n* **dist** copies all the JS and CSS files in the `./dist` folder.\n* **apps** builds the apps in the `./apps` folder [1].\n* **debug** builds debug version of the apps in the `./debug` folder [1].\n* **release** zips up the apps into individual archives in the `./release` folder [1]. \n\n[1] Running this task on macOS or Linux requires Wine, since it's needed to set the icon for the Windows app (build for specific platform to avoid errors).\n\n#### Build or release app for one specific platform\nTo build a specific release, use the command `release --platform=\"win32\"` for example.\nPossible OS'es are: `linux64`, `win32` and `osx64`\n\u003cbr\u003e`--installer` argument can be added to build installers for particular OS. NOTE: MacOS Installer can be built with MacOS only.\n\n#### macOS DMG installation background image\n\nThe release distribution for macOS uses a DMG file to install the application.\nThe PSD source for the DMG backgound image can be found in the root (`dmg-background.png`). After changing the source, export the image to PNG format in folder `./images/`.\n\n## Flight video won't load, or jumpy flight video upon export\n\nSome flight video formats aren't supported by Chrome, so the viewer can't open them. You can fix this by re-encoding\nyour video using the free tool [Handbrake][]. Open your original video using Handbrake. In the output settings, choose\nMP4 as the format, and H.264 as the video codec.\n\nBecause of [Google Bug #66631][], Chrome is unable to accurately seek within H.264 videos that use B-frames. This is\nmostly fine when viewing the flight video inside Blackbox Explorer. However, if you use the \"export video\" feature, this\nbug will cause the flight video in the background of the exported video to occasionally jump backwards in time for a\ncouple of frames, causing a very glitchy appearance.\n\nTo fix that issue, you need to tell Handbrake to render every frame as an intraframe, which will avoid any problematic\nB-frames. Do that by adding \"keyint=1\" into the Additional Options box:\n\n![Handbrake settings](screenshots/handbrake.png)\n\nHit start to begin re-encoding your video. Once it finishes, you should be able to load the new video into the Blackbox\nExplorer.\n\n[Handbrake]: https://handbrake.fr/\n[Google Bug #66631]: http://code.google.com/p/chromium/issues/detail?id=66631\n\n## License\n\nThis project is licensed under GPLv3.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FiNavFlight%2Fblackbox-log-viewer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FiNavFlight%2Fblackbox-log-viewer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FiNavFlight%2Fblackbox-log-viewer/lists"}