Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve UX: Add Firmware Update Links to Omi App #1808

Closed
skywinder opened this issue Feb 14, 2025 · 5 comments · Fixed by #1832
Closed

Improve UX: Add Firmware Update Links to Omi App #1808

skywinder opened this issue Feb 14, 2025 · 5 comments · Fixed by #1832

Comments

@skywinder
Copy link
Contributor

skywinder commented Feb 14, 2025

Is your feature request related to a problem? Please describe.

Currently, the iOS Omi app displays firmware update instructions in a pop-up window, but there is no way to copy the links or open them on another device (e.g., a laptop) for downloading the necessary files. This makes the update process cumbersome, especially when the required files need to be transferred to the device via a computer.

Describe the solution you'd like
• Add a section in the app (e.g., under “Device Settings” or “Firmware Update”) with the latest firmware update links.
• Alternatively, allow users to copy links from the pop-up window.

Additional context
Below is a screenshot showing the current pop-up window, which lacks direct access to update links:
Image


Additionally, the firmware update instructions are spread across three different locations, each with slightly different details:
1. In the app:

return await intercom.displayArticle('9995941-updating-your-devkit2-firmware');

2. On Discord (most relevant and up-to-date) – Discord Link
3. In the documentation – Omi Docs

This fragmentation creates ambiguity and makes it harder to ensure all update instructions remain consistent and up to date.

Proposed Solution
• Add a dedicated section in the app (e.g., under “Device Settings” or “Firmware Update”) that includes the latest firmware update links.
• Alternatively, enable users to copy links directly from the pop-up window.
• Consolidate all update instructions into a single, centralized location (e.g., the official documentation), with links from the app and Discord pointing there.

@skywinder skywinder mentioned this issue Feb 14, 2025
2 tasks
@kodjima33
Copy link
Collaborator

@skywinder Петь, we are a team of 3 and super understaffed

really like your experience - any chance you could help to solve this issue? Will do Bounty + highlight in the community

@skywinder
Copy link
Contributor Author

skywinder commented Feb 15, 2025

Hi, @kodjima33 Nik. Thank you for your response!

I truly appreciate it. I’m excited about that idea and have been exploring and doing R&D in that area myself.

I would love to contribute and see what I can accomplish on my end.

Once I have some insights, we can discuss the potential for future collaboration. I’m looking forward to it!

@mdmohsin7
Copy link
Collaborator

Hi @skywinder, here’s some additional information to make your work a bit easy. The article mentioned in the app is the one below. It is constantly updated to ensure it remains the most up-to-date source:
https://help.omi.me/en/articles/9995941-updating-your-devkit2-firmware

We maintain all our customer-facing guides on the Intercom Help Center. You can find more articles like this one there.
https://help.omi.me/en/

@skywinder
Copy link
Contributor Author

skywinder commented Feb 19, 2025

@mdmohsin7 Thanks for looking into this!

  1. Can we unify or sync these two pages? Who is responsible for merging or coordinating these documents?

  2. I recommend adding a direct link to GitHub Releases and an instruction to search for "Omi_DK" to find the proper DevKit update. It was confusing at first, so including it explicitly would really help new users.

  3. Also, could we bundle the latest DevKit .uf2 files with each release in the repository? That way, the full set of assets is in one place, making it more straightforward to download everything needed.

  4. By the way, help.omi.me seems to be down at the moment, and the video on the Flash Device page isn’t working either. Could someone look into that?

Image

@skywinder
Copy link
Contributor Author

for now I implemented some of the fixes to the doc to simplify the process
#1832

beastoin added a commit that referenced this issue Feb 24, 2025
- Added bootloader (v0.9.0) details and download link
- Improved video implementation:
  - Switched from GitHub-hosted to local video files
  - Added MP4 format with proper metadata
  - Fixed video playback and download links
- Enhanced documentation structure: 
  - Clear step-by-step flashing instructions
  - Added compatibility warnings between DevKit versions

- Added technical details:
  - Seeed XIAO nRF52840 Sense compatibility
  - Bootloader mode instructions

Added missed resources:
- DevKit2 Guide: help.omi.me/articles/9995941
- Bootloader: v2.0.1-Omi/bootloader0.9.0.uf2

partially fix #1808
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging a pull request may close this issue.

3 participants