From 0462ff2251360b9f3a4531f5345e09bbc9e4c938 Mon Sep 17 00:00:00 2001 From: Juan Fernandez Date: Tue, 29 Apr 2025 21:11:02 -0400 Subject: [PATCH 1/2] - Refactors the main content page into 4 subpages with changes to the MD to help with information hierarchy. - Adds info about needing to connect to wifi via QR code - Adds info about media capture requiring Ai Pins being online --- src/Routes.tsx | 27 +++- src/routes/about/OpenPin/Content.mdx | 120 ------------------ src/routes/about/OpenPin/Features/Content.mdx | 51 ++++++++ src/routes/about/OpenPin/Features/index.tsx | 15 +++ .../about/OpenPin/Installation/Content.mdx | 75 +++++++++++ .../about/OpenPin/Installation/index.tsx | 15 +++ .../about/OpenPin/Introduction/Content.mdx | 23 ++++ .../about/OpenPin/Introduction/index.tsx | 15 +++ src/routes/about/OpenPin/Support/Content.mdx | 72 +++++++++++ src/routes/about/OpenPin/Support/index.tsx | 15 +++ src/routes/about/OpenPin/index.tsx | 71 ++++++++++- 11 files changed, 372 insertions(+), 127 deletions(-) delete mode 100644 src/routes/about/OpenPin/Content.mdx create mode 100644 src/routes/about/OpenPin/Features/Content.mdx create mode 100644 src/routes/about/OpenPin/Features/index.tsx create mode 100644 src/routes/about/OpenPin/Installation/Content.mdx create mode 100644 src/routes/about/OpenPin/Installation/index.tsx create mode 100644 src/routes/about/OpenPin/Introduction/Content.mdx create mode 100644 src/routes/about/OpenPin/Introduction/index.tsx create mode 100644 src/routes/about/OpenPin/Support/Content.mdx create mode 100644 src/routes/about/OpenPin/Support/index.tsx diff --git a/src/Routes.tsx b/src/Routes.tsx index 99f435f..d699447 100644 --- a/src/Routes.tsx +++ b/src/Routes.tsx @@ -1,4 +1,8 @@ import OpenPin from "./routes/about/OpenPin"; +import Introduction from "./routes/about/OpenPin/Introduction"; +import Installation from "./routes/about/OpenPin/Installation"; +import Features from "./routes/about/OpenPin/Features"; +import Support from "./routes/about/OpenPin/Support"; import Interposers from "./routes/about/Interposers"; import Community from "./routes/about/Community"; import Installers from "./routes/installers/Installers"; @@ -16,8 +20,27 @@ const Routes = () => ( - - + + + + + + + + + + + + + + + + + + + + + diff --git a/src/routes/about/OpenPin/Content.mdx b/src/routes/about/OpenPin/Content.mdx deleted file mode 100644 index 044a402..0000000 --- a/src/routes/about/OpenPin/Content.mdx +++ /dev/null @@ -1,120 +0,0 @@ -import { YouTubeEmbed } from "src/components/YouTubeEmbed"; -import { Anchor } from "@mantine/core"; -import { Link } from "wouter"; - -### What is OpenPin? - -OpenPin is an open-source project which lets you use your Ai Pin after Humane bricked them. You can install it in a few clicks & without any ADB certs! - -### Installing OpenPin - -**Read all of the instructions before starting!** - - - -#### Requirements - -- An Ai Pin -- Any interposer (learn how to buy or build one here) -- A computer with Chrome - -#### Connecting to Ai Pin - -- Remove the moon sticker from the back of your Ai Pin -- Place Ai Pin in the interposer, connect the interposer to your computer -- Click 'connect' & select the "Ai Pin" USB device when presented with a popup - -##### Troubleshooting - -- **Ai Pin doesn't show up in USB popup?**
- Your pin is not correctly seated in the interposer, or your interposer is malfunctioning. Also make sure your pin is charged. -- **Ai Pin fails to connect (button doesn't change to say 'disconnect')**
- Check for a popup on the laser ink display confirming you want to let your computer connect. If this appears, click accept. -- **Other issues**
- Try reloading the page, or ask in the reHumane discord - -#### Installing the Client - -- Go to Installers > OpenPin > Install OpenPin > Run Action -- Click 'Run' and confirm the installation was successful - -#### Linking your Ai Pin - -##### Getting your link code - -- Go to [openpin.center](https://openpin.center/) -- Create an account -- Click 'add device', a QR code should appear - -##### Opening Settings - -- Now, on your Ai Pin, tap to wake it then hold up your hand for the laser ink display -- Push your hand out to navigate to the Launcher, then roll your palm to select 'Settings' - -##### Enable WiFi - -- Select 'Other Settings' -- When the confirmation screen appears, double-tap the touchpad to confirm navigation -- Ensure WiFi is connected -- Double-tap the touchpad again to get back to the OpenPin Client - -##### Scan link code - -- Select 'Link Device' and bring the QR code into the view of Ai Pin's Camera -- A sound should play -- You're all done! - -### Using OpenPin - -#### Assistant - -Hold the touchpad with one finger and speak. Double-tap the touchpad with one finger to stop Ai Pin's response. - -##### Notes - -Ai Pin will automatically create notes where appropriate, or you can explicity ask it to. You can view these in .Center. - -##### Navigation - -You can ask Ai Pin things like: - -- 'Where am I?' -- 'What are some pizza places near me' -- 'Navigate me to X' - -##### Other Assistant features - -Includes: weather, stocks, and web browsing. - -#### Assistant with Vision - -Tap, then hold the touchpad with one finger and speak. After you finish speaking, Ai Pin will capture a photo to analyze. - -#### Translate - -Hold the touchpad with two fingers and speak. You can change the language Ai Pin translates to/from in .Center. -Ai Pin will automatically detect the 'direction' of the translation and speak the translated result in the other language. - -#### Captures - -Captures show up in .Center and can be easily viewed and downloaded. - -##### Capturing Photos - -Double-tap the touchpad with two fingers to take a photo. - -##### Capturing Videos - -Tap then hold the touchpad with two fingers to take a video. You can release your fingers when you hear a sound. -Videos run for 15s, but you can also manually stop them by double-tapping the touchpad with one finger. - -### Relaunching OpenPin - -If Ai Pin ever runs fully out of battery, or something goes very wrong, you will need to relaunch OpenPin. - -- Go to Installers > OpenPin > Relaunch OpenPin > Run Action -- Click 'Run' and confirm the relaunch was successful - -### Need Help? - -See 'Community'. diff --git a/src/routes/about/OpenPin/Features/Content.mdx b/src/routes/about/OpenPin/Features/Content.mdx new file mode 100644 index 0000000..2a9dae8 --- /dev/null +++ b/src/routes/about/OpenPin/Features/Content.mdx @@ -0,0 +1,51 @@ +import { Anchor } from "@mantine/core"; +import { Link } from "wouter"; + +# OpenPin Features + +## Assistant Mode + +Hold the touchpad with one finger and speak. Double-tap the touchpad with one finger to stop Ai Pin's response. + +### Notes +Ai Pin will automatically create notes where appropriate, or you can explicitly ask it to. You can view these in .Center. + +### Navigation +You can ask Ai Pin things like: + +- 'Where am I?' +- 'What are some pizza places near me' +- 'Navigate me to X' + +### Other Assistant Features +Includes: weather, stocks, and web browsing. + +--- + +## Assistant with Vision + +Tap, then hold the touchpad with one finger and speak. After you finish speaking, Ai Pin will capture a photo to analyze. + +--- + +## Translation Mode + +Hold the touchpad with two fingers and speak. You can change the language Ai Pin translates to/from in .Center. + +Ai Pin will automatically detect the 'direction' of the translation and speak the translated result in the other language. + +--- + +## Media Capture + +Captures show up in .Center and can be easily viewed and downloaded. + +> **Important:** An active WiFi connection is required for all photo and video captures to function properly. The capture feature will not work if your Ai Pin is offline. + +### Taking Photos +Double-tap the touchpad with two fingers to take a photo. + +### Recording Videos +Tap then hold the touchpad with two fingers to take a video. You can release your fingers when you hear a sound. + +Videos run for 15s, but you can also manually stop them by double-tapping the touchpad with one finger. \ No newline at end of file diff --git a/src/routes/about/OpenPin/Features/index.tsx b/src/routes/about/OpenPin/Features/index.tsx new file mode 100644 index 0000000..777ce34 --- /dev/null +++ b/src/routes/about/OpenPin/Features/index.tsx @@ -0,0 +1,15 @@ +import Content from "./Content.mdx"; +import PageLayout from "../../../../layouts/PageLayout"; +import { TypographyStylesProvider } from "@mantine/core"; + +const Features = () => { + return ( + + + + + + ); +}; + +export default Features; \ No newline at end of file diff --git a/src/routes/about/OpenPin/Installation/Content.mdx b/src/routes/about/OpenPin/Installation/Content.mdx new file mode 100644 index 0000000..7f4d216 --- /dev/null +++ b/src/routes/about/OpenPin/Installation/Content.mdx @@ -0,0 +1,75 @@ +import { YouTubeEmbed } from "src/components/YouTubeEmbed"; +import { Anchor } from "@mantine/core"; +import { Link } from "wouter"; + +# Installing OpenPin + +> **Important:** Read all of the instructions before starting! + + + +## What You'll Need + +- An Ai Pin +- Any interposer (learn how to buy or build one here) +- A computer with Chrome + +--- + +## Step 1: Connect Your Ai Pin + +- Remove the moon sticker from the back of your Ai Pin +- Place Ai Pin in the interposer, connect the interposer to your computer +- Click 'connect' & select the "Ai Pin" USB device when presented with a popup + +### Troubleshooting Connection Issues + +**Ai Pin doesn't show up in USB popup** +This typically indicates an improper connection between the Ai Pin and interposer. Ensure your Ai Pin has sufficient battery charge, then verify the positioning in the interposer. For optimal contact, gently adjust the Ai Pin's position within the interposer to align the connection points properly. It's *possible* that your interposer, is malfunctioning. + + +**Ai Pin fails to connect** +Check for a popup on the laser ink display confirming you want to let your computer connect. If this appears, click accept. + +**Other issues** +Try reloading the page, or ask in the [reHumane discord](https://discord.gg/JtQzPHFeBc). + +--- + +## Step 2: Install the Client + +- Go to Installers > OpenPin > Install OpenPin > Run Action +- Click 'Run' and confirm the installation was successful + +--- + +## Step 3: Link Your Ai Pin + +### 3.1 Get Your Link Code +- Go to [openpin.center](https://openpin.center/) +- Create an account +- Click 'add device', a QR code should appear + +### 3.2 Open Settings on Your Ai Pin +- Now, on your Ai Pin, tap to wake it then hold up your hand for the laser ink display +- Push your hand out to navigate to the Launcher, then roll your palm to select 'Settings' + +### 3.3 Enable WiFi +- Select 'Other Settings' +- When the confirmation screen appears, double-tap the touchpad to confirm navigation +- Ensure WiFi is connected +- Double-tap the touchpad again to get back to the OpenPin Client + +### 3.4 Scan the Link Code +- Select 'Link Device' and bring the QR code into the view of Ai Pin's Camera +- A sound should play when successful +- You're all done! + +--- + +## Relaunching OpenPin + +If Ai Pin ever runs fully out of battery, or something goes very wrong, you will need to relaunch OpenPin. + +1. Go to Installers > OpenPin > Relaunch OpenPin > Run Action +2. Click 'Run' and confirm the relaunch was successful \ No newline at end of file diff --git a/src/routes/about/OpenPin/Installation/index.tsx b/src/routes/about/OpenPin/Installation/index.tsx new file mode 100644 index 0000000..4fd69e1 --- /dev/null +++ b/src/routes/about/OpenPin/Installation/index.tsx @@ -0,0 +1,15 @@ +import Content from "./Content.mdx"; +import PageLayout from "../../../../layouts/PageLayout"; +import { TypographyStylesProvider } from "@mantine/core"; + +const Installation = () => { + return ( + + + + + + ); +}; + +export default Installation; \ No newline at end of file diff --git a/src/routes/about/OpenPin/Introduction/Content.mdx b/src/routes/about/OpenPin/Introduction/Content.mdx new file mode 100644 index 0000000..1ee41a8 --- /dev/null +++ b/src/routes/about/OpenPin/Introduction/Content.mdx @@ -0,0 +1,23 @@ +import { Anchor } from "@mantine/core"; +import { Link } from "wouter"; + +### What is OpenPin? + +OpenPin is an open-source project which lets you use your Ai Pin after Humane bricked them. You can install it in a few clicks & without any ADB certs! + +### Key Features + +- **Assistant**: Voice commands for answers, navigation, weather, and web browsing +- **Visual Analysis**: Analyze images with AI +- **Translation**: Real-time language translation +- **Media Capture**: Take photos and 15-second videos + +All content syncs with .Center for easy management. + +### Quick Start + +You'll need an Ai Pin, an interposer, and a computer with Chrome. See our Installation Guide for detailed steps. + +### Support + +Having issues? Check that your Pin is properly connected, charged, and has WiFi enabled. Visit our Support Page or Community for help. \ No newline at end of file diff --git a/src/routes/about/OpenPin/Introduction/index.tsx b/src/routes/about/OpenPin/Introduction/index.tsx new file mode 100644 index 0000000..694deab --- /dev/null +++ b/src/routes/about/OpenPin/Introduction/index.tsx @@ -0,0 +1,15 @@ +import Content from "./Content.mdx"; +import PageLayout from "../../../../layouts/PageLayout"; +import { TypographyStylesProvider } from "@mantine/core"; + +const Introduction = () => { + return ( + + + + + + ); +}; + +export default Introduction; \ No newline at end of file diff --git a/src/routes/about/OpenPin/Support/Content.mdx b/src/routes/about/OpenPin/Support/Content.mdx new file mode 100644 index 0000000..e2e4151 --- /dev/null +++ b/src/routes/about/OpenPin/Support/Content.mdx @@ -0,0 +1,72 @@ +import { Anchor } from "@mantine/core"; +import { Link } from "wouter"; + +# OpenPin Support + +For help with OpenPin, visit our Community page. + +## Common Issues & Solutions + +### Connection Issues + +- **Ai Pin doesn't show up in USB popup** + This typically indicates an improper connection between the Ai Pin and interposer. Ensure your Ai Pin has sufficient battery charge, then verify the positioning in the interposer. For optimal contact, gently adjust the Ai Pin's position within the interposer to align the connection points properly. It's *possible* that your interposer, is malfunctioning. + +- **Ai Pin fails to connect** + Check for a popup on the laser ink display confirming you want to let your computer connect. If this appears, click accept. + +- **Other connection problems** + Ensure your Ai Pin is properly seated in the interposer, check that the interposer is properly connected to your computer, and make sure your Ai Pin has sufficient battery. + +--- + +### Installation Problems + +> **If installation fails:** +> +> 1. Try rebooting both your computer and Ai Pin +> 2. Ensure you have a stable internet connection during the installation process +> 3. Make sure you're using Google Chrome (other browsers may not work properly) + +--- + +### Relaunching OpenPin + +If Ai Pin ever runs fully out of battery, or something goes very wrong, you will need to relaunch OpenPin. + +#### How to Relaunch: + +1. Go to Installers > OpenPin > Relaunch OpenPin > Run Action +2. Click 'Run' and confirm the relaunch was successful + +--- + +### Connecting to Wifi Networks while using OpenPin + +The Ai Pin requires an active WiFi connection for many features to work properly. However, the voice interface doesn't support entering WiFi passwords, so you'll need to use a QR code method instead. + +#### Generating a WiFi QR Code: + +1. Visit the [Ai Pin WiFi QR Code Generator](https://agg23.github.io/ai-pin-wifi-qr-generator/) +2. Enter your WiFi network name (SSID) +3. Select your security type (typically WPA) +4. Enter your WiFi password +5. Check "Hidden SSID" if your network is hidden +6. Click "Generate QR Code" + +#### Connecting Your Ai Pin to WiFi: + +1. On your Ai Pin, tap to wake it then hold up your hand for the laser ink display +2. Navigate to Settings > Other Settings > WiFi +3. Select "Connect to WiFi" or "Scan QR Code" +4. Point your Ai Pin camera at the generated QR code +5. The Ai Pin will scan the code and automatically connect to your network + +--- + +## Getting More Help + +If you're still experiencing issues: + +- Join our Community Discord for real-time assistance +- Report bugs by creating an issue on our [GitHub repository](https://github.com/MaxMaeder/OpenPin) \ No newline at end of file diff --git a/src/routes/about/OpenPin/Support/index.tsx b/src/routes/about/OpenPin/Support/index.tsx new file mode 100644 index 0000000..1765a37 --- /dev/null +++ b/src/routes/about/OpenPin/Support/index.tsx @@ -0,0 +1,15 @@ +import Content from "./Content.mdx"; +import PageLayout from "../../../../layouts/PageLayout"; +import { TypographyStylesProvider } from "@mantine/core"; + +const Support = () => { + return ( + + + + + + ); +}; + +export default Support; \ No newline at end of file diff --git a/src/routes/about/OpenPin/index.tsx b/src/routes/about/OpenPin/index.tsx index aaed477..e01e30e 100644 --- a/src/routes/about/OpenPin/index.tsx +++ b/src/routes/about/OpenPin/index.tsx @@ -1,13 +1,74 @@ -import Content from "./Content.mdx"; import PageLayout from "../../../layouts/PageLayout"; -import { TypographyStylesProvider } from "@mantine/core"; +import { Button, Group, Stack, Title, Text, SimpleGrid, Card, Center } from "@mantine/core"; +import { Link } from "wouter"; const OpenPin = () => { return ( - - - + + + OpenPin is an open-source project which lets you use your Ai Pin after Humane bricked them. + You can install it in a few clicks & without any ADB certs! + + + + + +
+ Introduction +
+ + + Learn what OpenPin is and how it can help you use your Ai Pin. + + + + + + +
+ Installation +
+ + + Step-by-step guide to install OpenPin on your Ai Pin device. + + + + + + +
+ Features +
+ + + Explore the features and capabilities of OpenPin. + + + + + + +
+ Support +
+ + + Get help with common issues and learn how to troubleshoot. + + + + + ); }; From a2f65b11560d9877cd11431957d95505f61ee24b Mon Sep 17 00:00:00 2001 From: Juan Jose Fernandez <51770306+juanjosefernandez@users.noreply.github.com> Date: Fri, 2 May 2025 07:48:23 -0400 Subject: [PATCH 2/2] Update src/routes/about/OpenPin/Installation/Content.mdx Co-authored-by: mefogle --- src/routes/about/OpenPin/Installation/Content.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/routes/about/OpenPin/Installation/Content.mdx b/src/routes/about/OpenPin/Installation/Content.mdx index 7f4d216..ff076d3 100644 --- a/src/routes/about/OpenPin/Installation/Content.mdx +++ b/src/routes/about/OpenPin/Installation/Content.mdx @@ -30,7 +30,7 @@ This typically indicates an improper connection between the Ai Pin and interpose **Ai Pin fails to connect** Check for a popup on the laser ink display confirming you want to let your computer connect. If this appears, click accept. - +If you are running Android Studio, shut down Android Studio and execute the command 'adb kill-server` as adb will block the connection from OpenPin Hub. **Other issues** Try reloading the page, or ask in the [reHumane discord](https://discord.gg/JtQzPHFeBc).