User Manual - Revision history

Jasx at 12:23, 4 February 2026

2026-02-04T12:23:15Z

← Older revision		Revision as of 12:23, 4 February 2026
Line 6:		Line 6:

	== First steps ==		== First steps ==
	* Your device may arrive uncharged or with low charge. Plug the USB port into a charger. A red LED will light up. On charge completion, a green or blue LED will light up next to the charge port.		# Your device may arrive uncharged or with low charge. Plug the USB port into a charger. A red LED will light up. On charge completion, a green or blue LED will light up next to the charge port.
	* On the side of the device (next to the charging port), is an on/off switch. It's recommended to charge with the device being off.		# On the side of the device (next to the charging port), is an on/off switch. It's recommended to charge with the device being off.
	* The charging may take up to 3 hours. ''Footnotes: The reason it takes so long to charge is because the USB spec for computers is limited to 500mA, and the battery size is 1500mAh. Smart charge modules are still quite pricey, so this was a price/user-friendliness tradeoff.''		# The charging may take up to 3 hours. ''Footnotes: The reason it takes so long to charge is because the USB spec for computers is limited to 500mA, and the battery size is 1500mAh. Smart charge modules are still quite pricey, so this was a price/user-friendliness tradeoff.''

	== Connecting to WiFi ==		== Connecting to WiFi ==
Line 15:		Line 15:
	Note: You can always enter configuration mode by holding down the configuration button (next to the USB charge port) until the status LED turns blue.		Note: You can always enter configuration mode by holding down the configuration button (next to the USB charge port) until the status LED turns blue.

	* Use a phone, laptop, or other WiFi device and look for networks. Locate the network called VibHub Micro (or similar for your device), and connect to it.		# Use a phone, laptop, or other WiFi device and look for networks. Locate the network called VibHub Micro (or similar for your device), and connect to it.
	* On a phone, you usually get the popup "this network requires login" or similar, in which case click that button to enter the captive portal. If not, you can manually open a browser and go to http://192.168.4.1		# On a phone, you usually get the popup "this network requires login" or similar, in which case click that button to enter the captive portal. If not, you can manually open a browser and go to http://192.168.4.1
	* '''Make note of the device ID''', which is the random letters and numbers in the yellow box. This is your "key" used to grant applications access to your device. Click the device ID to copy it. If you want to deauthorize all applications, you can generate a new device id (see below).		# '''Make note of the device ID''', which is the random letters and numbers in the yellow box. This is your "key" used to grant applications access to your device. Click the device ID to copy it. If you want to deauthorize all applications, you can generate a new device id (see below).
	* Click ''Setup'' to configure WiFi.		# Click ''Setup'' to configure WiFi.
	* The WiFi page lists detected access points. Click the WiFi you want to connect to.		# The WiFi page lists detected access points. Click the WiFi you want to connect to.
	* Enter the WiFi password.		# Enter the WiFi password.
	* Press ''Save''. And wait for the device to reboot.		# Press ''Save''. And wait for the device to reboot.
	* If the Status LED turns GREEN, you're ready to start using the device! If it turns blue, reconnect to the device WiFi and make sure you entered the correct WiFi credentials.		# If the Status LED turns GREEN, you're ready to start using the device! If it turns blue, reconnect to the device WiFi and make sure you entered the correct WiFi credentials.

	== Using an App ==		== Using an App ==
Line 30:		Line 30:
	If you just want to quickly test if your device works, try the socket demo: https://jasxsl.github.io/VibHub-SocketDemo/		If you just want to quickly test if your device works, try the socket demo: https://jasxsl.github.io/VibHub-SocketDemo/

	* Paste your device ID into the text box. When connected, some sliders will be shown. ''Note: The VibHub cannot be used by an app while in WiFi configuration mode (blue LED).''		# Paste your device ID into the text box. When connected, some sliders will be shown. ''Note: The VibHub cannot be used by an app while in WiFi configuration mode (blue LED).''
	* Drag the first two sliders up to max. You should see the blue LEDs on the USB vibrator ports on your device light up (and any vibrator plugged in will start moving).		# Drag the first two sliders up to max. You should see the blue LEDs on the USB vibrator ports on your device light up (and any vibrator plugged in will start moving).
	* Pressing "send pulse" sends a pulse program.		# Pressing "send pulse" sends a pulse program.
	* Pressing "Get Battery" gets a battery voltage reading (if supported).		# Pressing "Get Battery" gets a battery voltage reading (if supported).

	== Reconfiguring ==		== Reconfiguring ==

	* To reconfigure your device. Turn it on first. Then long-press the config button until the status LED turns a solid blue.		# To reconfigure your device. Turn it on first. Then long-press the config button until the status LED turns a solid blue.
	* Connect again via WiFi (see first steps).		# Connect again via WiFi (see first steps).

	=== Change device ID ===		=== Change device ID ===
	''Note: Changing device ID will de-authorize all apps that have access to your device.''		''Note: Changing device ID will de-authorize all apps that have access to your device.''

	* After entering the configuration portal, press New Normal ID to replace your current ID		# After entering the configuration portal, press New Normal ID to replace your current ID
	* You can also choose to generate a secure ID. A secure ID is longer and mixes upper and lower case characters.		# You can also choose to generate a secure ID. A secure ID is longer and mixes upper and lower case characters.

	=== Factory Reset ===		=== Factory Reset ===
	Factory reset will reset all configuration, including WiFi settings and your device ID. This can be useful if you intend to sell or give your device away and want to reset any personal information.		Factory reset will reset all configuration, including WiFi settings and your device ID. This can be useful if you intend to sell or give your device away and want to reset any personal information.

	To perform a factory reset, turn your device off, then hold the config button while starting it. The status LED will flash RED. Upon performing a factory reset, the device will automatically enter WiFi configuration mode when started.		# To perform a factory reset, turn your device off, then hold the config button while starting it. The status LED will flash RED. Upon performing a factory reset, the device will automatically enter WiFi configuration mode when started.

	=== Custom Server ===		=== Custom Server ===
			VibHub is fully open source, so if you want to host your own server, you absolutely can (install instructions here: https://github.com/JasXSL/VibHub-Server/)! Or maybe you just want to connect to someone else's server.

			# In config mode, click Setup.
			# At the bottom of the page, enter server host and server port. Do ''not'' use http or https:// etc in the server host, just the domain.

			== Status indicator ==
			The status LED is located toward the USB output ports (where you plug in vibrators).
			{\| class="wikitable"
			\|+
			!Color
			!Status
			\|-
			\|Solid Blue
			\|Device is in WiFi Configuration mode. You can connect to it via WiFi, and configure it at http://192.168.4.1
			\|-
			\|Solid Green
			\|Device is connected and operational!
			\|-
			\|Slow flashing green/yellow
			\|Device is connected and operational, but battery is low.
			\|-
			\|Flashing blue/red
			\|WiFi error, try restarting or reconfiguring.
			\|-
			\|Flashign red/green
			\|Socket error, check if your server (usually vibhub.io) is up?
			\|-
			\|Cyan
			\|Connecting...
			\|-
			\|Slow red blink
			\|Disconnected from server.
			\|-
			\|Pink Flash
			\|A websocket app has connected to our device.
			\|}

Jasx at 12:14, 4 February 2026

2026-02-04T12:14:09Z

@@ Line 5: / Line 5: @@
 * The VibHub USB output ports are ONLY for powering motors or similar simple devices such as lights. '''DO NOT USE THEM TO CHARGE COMPLEX DEVICES, OR YOU MAY CAUSE DAMAGE TO THEM!'''
-=== First steps ===
+== First steps ==
 * Your device may arrive uncharged or with low charge. Plug the USB port into a charger. A red LED will light up. On charge completion, a green or blue LED will light up next to the charge port.
 * On the side of the device (next to the charging port), is an on/off switch. It's recommended to charge with the device being off.
 * The charging may take up to 3 hours. ''Footnotes: The reason it takes so long to charge is because the USB spec for computers is limited to 500mA, and the battery size is 1500mAh. Smart charge modules are still quite pricey, so this was a price/user-friendliness tradeoff.''
-=== Connecting to WiFi ===
+== Connecting to WiFi ==
 The VibHub uses WiFi to communicate. The first time you turn on your device, the status LED (near the USB output ports) will turn a solid blue, indicating that the device is in configuration mode.
 Note: You can always enter configuration mode by holding down the configuration button (next to the USB charge port) until the status LED turns blue.
-* Use a phone, laptop, or other WiFi device and look for networks. Locate the
+* Use a phone, laptop, or other WiFi device and look for networks. Locate the network called VibHub Micro (or similar for your device), and connect to it.

Jasx: Created page with "VibHub is an open source, open hardware vibrator controller. It allows you to turn any non-battery-driven USB vibrator into a smart internet capable one, supporting 2 ports for the VibHub micro, and 4 ports for the classic 4xAA version. This manual is focused on the newer VibHub Micro version, but a lot of what's written here is also true for the older 4x AA version. === WARNING === * The VibHub USB output ports are ONLY for powering motors or similar simple devices su..."

2026-02-04T11:29:43Z

Created page with "VibHub is an open source, open hardware vibrator controller. It allows you to turn any non-battery-driven USB vibrator into a smart internet capable one, supporting 2 ports for the VibHub micro, and 4 ports for the classic 4xAA version. This manual is focused on the newer VibHub Micro version, but a lot of what's written here is also true for the older 4x AA version. === WARNING === * The VibHub USB output ports are ONLY for powering motors or similar simple devices su..."

New page

VibHub is an open source, open hardware vibrator controller. It allows you to turn any non-battery-driven USB vibrator into a smart internet capable one, supporting 2 ports for the VibHub micro, and 4 ports for the classic 4xAA version. This manual is focused on the newer VibHub Micro version, but a lot of what's written here is also true for the older 4x AA version.

=== WARNING ===

* The VibHub USB output ports are ONLY for powering motors or similar simple devices such as lights. '''DO NOT USE THEM TO CHARGE COMPLEX DEVICES, OR YOU MAY CAUSE DAMAGE TO THEM!'''

=== First steps ===

* Your device may arrive uncharged or with low charge. Plug the USB port into a charger. A red LED will light up. On charge completion, a green or blue LED will light up next to the charge port.
* On the side of the device (next to the charging port), is an on/off switch. It's recommended to charge with the device being off.
* The charging may take up to 3 hours. ''Footnotes: The reason it takes so long to charge is because the USB spec for computers is limited to 500mA, and the battery size is 1500mAh. Smart charge modules are still quite pricey, so this was a price/user-friendliness tradeoff.''

=== Connecting to WiFi ===
The VibHub uses WiFi to communicate. The first time you turn on your device, the status LED (near the USB output ports) will turn a solid blue, indicating that the device is in configuration mode.

Note: You can always enter configuration mode by holding down the configuration button (next to the USB charge port) until the status LED turns blue.

* Use a phone, laptop, or other WiFi device and look for networks. Locate the