Warning! Ensure that the main electrical power (EB), UPS, and all other power sources are completely shut down before proceeding.
1. Power-Up Switch Box
Connect either EB or UPS power supply to the terminals labeled:
P (Phase)
N (Neutral)
E (Earth)
While using UPS is optional, it is recommended for uninterrupted power.
2. Switch Terminal Connection
There is no internal link between the power input terminals and the switch outputs. Connect wires from your power source (EB or UPS) to the IN terminal for each switch, and the appliance to the OUT terminal.
This design simulates a traditional switch for easier installation and familiarity.
Wi-Fi and Location Services are enabled on your phone.
Steps to Configure
Enable Wi-Fi Configuration Mode on the switch box using either method:
Option A — Remote control: Press L9, then L3 immediately.
Option B — Touch button: Press and hold the first touch switch for 15 seconds.
The switch box LED will start blinking, indicating Wi-Fi mode is active.
In the GSOFT app: Settings Device Wi-Fi Setup
Enter your Wi-Fi SSID and password (2.4GHz only).
Tap Submit and accept any permission prompts.
On success, a green confirmation message appears. The device will show on the Home screen.
Note: Use 2.4GHz Wi-Fi only. 5GHz networks are not supported by the device.
2
Software Features
Day-to-day usage and customization once your device is online: control switches, set timers and scenes, manage users and roles, voice control, and advanced options.
The home page shows all your devices organized by location groups. Each device displays its switches and fans with real-time status (online/offline).
Tap any switch toggle to turn it ON/OFF instantly.
Tap the blue arrow on a device to access Configure, User, and Settings tabs.
Fan speed can be adjusted directly from the home page using speed controls. Speeds run 0–4; a BLDC fan is drawn as a plain ON/OFF switch, because its speed is set on the fan's own remote.
Device header color and name color are customizable from device settings.
Automate switches and fan speeds with scheduled timers. Internet is needed only during timer creation or deletion — once set, timers run independently.
Timer Type
Description
Once
Executes once and auto-deletes.
Daily
Triggers every day at the set time.
Weekly
Triggers on selected days of the week. Supports multi-day selection (Weekdays, Weekend, All).
Cyclic
Repeats at a fixed interval (e.g., every 30 minutes). NEW
Monthly
Triggers on specific dates each month.
Yearly
Triggers on specific dates annually.
Create a New Timer
Navigate to: Device Configure Timer Icon
Tap Add Timer.
Choose timer type, set start/end time and ON/OFF state.
Tap Submit.
Delete a Timer
In the timer list, tap the red X icon next to the timer to remove it.
Control multiple switches across different devices with a single tap or automatic triggers. Scenes support per-switch delays for complex automation sequences.
Mode
Description
User Control
Triggered manually by tapping the scene button in the app.
Event Control
Triggered automatically when a switch/fan state changes (e.g., turning on switch 1 triggers a sequence).
Create a Scene
Tap Scene at the bottom of the app.
Tap New Scene.
Set scene name (e.g., "Party Mode", "Evening Mood").
Select scene mode in Enable by.
Configure trigger conditions and action list with optional delays.
Tap Submit.
Scenes require an active internet connection since they are executed by the server.
Mark frequently used switches as favorites for one-tap access without navigating into each device. Great for the few switches you operate dozens of times a day (porch light, master bedroom fan, front gate, etc.).
Add a Switch to Favorites
Navigate to: Home Device Configure Settings Gear on any switch.
Tap the heart icon in the header to add the switch.
A heart-shaped floating action button appears on the home page. Tap it to expand a horizontal wheel of your favorites.
Tap any favorite to toggle that switch from anywhere in the app.
Supports switches from any of your devices in one place.
Each user has their own favorites list — your favorites don't affect other users on the same device.
The bell icon in the home page header carries messages from GSOFT. A red badge shows how many you have not read yet (it stops counting at 9+).
Type
What it usually says
Software Update
A new firmware or app version is going out, and what changed in it.
Maintenance
Planned server work, and the window during which cloud features may be interrupted.
Announcement
New products, features, and general service news.
Tap a message to read it in full — some carry an image or a link — and it is marked read. The green tick on a row marks it read without opening it.
These are service messages from us, not device alerts: the app does not notify you when a switch turns on or a device goes offline. They also appear only while you have the app open — GSOFT sends no push notifications to your phone's lock screen.
Add family members, tenants, employees, or guests to control the device without sharing your login credentials. Each user is invited by email and signs in with their own GSOFT account.
Add a User
Navigate to: Device User Tab
Tap Add User.
Enter the new user's registered email address.
Pick a role for the user (see Property Type & User Roles below).
Tick the individual switches this user may operate.
Optionally set an Access Period — see below.
Tap Submit.
Access Period NEW
Access can be given for a fixed stretch of time instead of until you remember to withdraw it. On the same screen, From and Till each open a date and time picker; leave either one unset for no limit on that end. Outside the window the user keeps their account but the device stops answering them.
Built for the cases where access is temporary by nature — a guest staying the weekend, a contractor on site for a week, a patient's room, a service engineer.
The user's row shows the window underneath their name, for example Access: 20 Sep 2026, 11:54 AM → 21 Sep 2026, 11:58 AM, tagged not started or expired when it is not currently in force.
You can add or change the window later from the gear icon on the user's row, along with their role and switch permissions.
An Owner or Admin cannot be given an access period — the top role on a device is always open-ended.
Remove a User
In the User list, tap the red X icon next to the user to remove them. Tenants you remove also lose access for any guests they previously added (cascading delete preserves privacy).
The roles available for a device depend on its Property Type (Home / Stay / Hospital / Office). See the next section for the role catalog and what each role can do.
Each device has a Property Type that determines which user roles are available, so the access model fits the actual installation. Set it from Device Setting Property Type.
Roles Available per Property Type
Pick the Property Type that matches your installation, then assign each user one of the roles listed for that type. Each Property Type below is shown as its own card with the roles it supports.
HomeDefaultResidential homes & apartments
Owner
Highest
Holds top authority over the device. Can add or remove any user (including Tenants), assign any role, change Property Type, modify all device settings, configure switches, control all non-Tenant switches by voice. Only one Owner per device.
Privacy boundary with Tenants: The Owner manages Tenant lifecycle (add/remove) but does not see what Tenants are doing — Tenant switches' real-time on/off state, usage history, timers, and scenes are hidden from the Owner. Use the Tenant role when you want to grant a renter or sub-unit occupant true independent control without the Owner peering into their daily activity.
Member
Mid
For trusted family members. Can control all switches, can invite Guests, sees the full activity history of everyone on the device. No restrictions on visibility — use this when family members are comfortable seeing each other's usage.
Tenant
Mid
For renters, sub-units, or independent occupants who pay for their own privacy.
Independent control: Has full control over the switches assigned to them — turn on/off, set timers, create scenes, control by voice. Can add their own Guests. The Tenant's Guests are private (other Tenants and Members can't see them).
Privacy from the Owner: The device Owner can only add or remove the Tenant — the Owner cannot see the Tenant's switch states (on/off), usage history, timers, scenes, or who the Tenant added as Guests. Tenants effectively operate as their own private subtree on a shared device.
Cascade on removal: When the Owner removes a Tenant, every Guest the Tenant added is also removed automatically — preserving the privacy boundary even on exit.
Guest
Lowest
For visitors. Can use switches assigned to them. Cannot add or remove other users, cannot change any device setting, cannot change Property Type.
StayHotels, lodges, Airbnb rentals
Admin
Highest
For the property owner or manager who runs the establishment. Can add or remove any user, assign any role, change Property Type, modify device settings, configure switches, control everything by voice.
Manager
Mid
For front-desk staff or housekeeping leads. Can control switches and add Guests (e.g., check-in a new occupant). Can remove only Guests they themselves added. Cannot modify device settings or change Admin/Manager assignments.
Guest
Lowest
For staying guests (a hotel customer, an Airbnb visitor). Can use the switches in their room. Cannot add or remove users, cannot access settings, cannot see other guests.
HospitalPatient rooms, clinics, wards
Admin
Highest
For the hospital administrator or facility manager. Can add or remove any user, assign any role, change Property Type, modify device settings, configure switches, control everything by voice.
Manager
Mid
For ward in-charge, head nurse, or shift supervisor. Can control switches and add Guests (e.g., assign access to a new patient or attendant). Can remove only Guests they themselves added. Cannot modify device settings.
Guest
Lowest
For patients, attendants, or visitors. Can use the switches in their room (lights, fan, etc.). Cannot add other users, cannot access settings, cannot see other patients.
OfficeOffices, co-working spaces, shops
Admin
Highest
For the business owner or IT/facilities lead. Can add or remove any user, assign any role, change Property Type, modify device settings, configure switches, control everything by voice.
Manager
Mid
For team leads, department heads, or office supervisors. Can control switches and add Users (e.g., onboard a new employee). Can remove only Users they themselves added. Cannot modify device settings.
User
Lowest
For regular employees or co-working members. Can use the switches assigned to them (their workstation, meeting room, etc.). Cannot add other users, cannot access settings.
How to use: Set the Property Type first from Device Setting Property Type. When you then go to User Tab → Add User, the role dropdown will only show roles valid for that Property Type — no need to memorize.
Per-Switch Permissions NEW
Beyond roles, you can grant or restrict access to individual switches per user. This is useful when, for example, a Guest should only be able to control bedroom lights but not the AC. Navigate to Device User User name Permissions and select which switches they can control.
Tip: Changing Property Type after users are added will keep existing user assignments where possible. Roles that don't exist in the new type are mapped to the closest available level.
Groups are how a long device list stays usable: a group is typically a building or a floor, and each group holds sub-groups — the rooms. The home page then filters down to one of them instead of scrolling past everything you own.
Both screens live on the Setting tab at the bottom of the app: Device Groups and Device List Order.
Create Groups & Sub-Groups
Navigate to: Setting Device Groups
Tap + in the header to create a group. Tap the group to open it, then + again for a sub-group.
Open a sub-group and use Add devices to put devices in it; the button on each row takes a device back out.
The ⋮ on any row renames or deletes it.
Every change is saved as you make it — there is no Submit button on this screen.
"All" is ours, not yours.All Location holds every device you have, and inside each group All is the combined list of that group's sub-groups. Both are maintained for you, so they appear in the home-page filter but cannot be renamed, deleted, or have devices added to or removed from them.
Reorder Devices
Navigate to: Setting Device List Order
Pick the group and sub-group you want to arrange from the dropdowns.
Drag devices into your preferred order.
Tap Submit.
The order is stored per sub-group, so the same device can sit first in one view and further down in another.
Control your switches by voice through Amazon Alexa or Google Home. Each device can be individually enabled or disabled for voice control.
Enable Voice Control
Navigate to: Device Setting Tab
Toggle Alexa Support or Google Home Support ON.
Link your GSOFT account in the Alexa/Google Home app.
Discover devices — only enabled devices will appear.
Tip for large installations: Voice assistants treat each switch as a separate device. For 60+ switch boxes, enable voice control only on frequently used devices to avoid hitting Alexa/Google node limits.
Per-Switch Voice Lock
You can lock individual switches from Alexa or Google control (e.g., to prevent children from controlling specific switches by voice). Navigate to the switch's settings gear in Configure page and use Lock Alexa or Lock Google.
Momentary — ON while pressed, OFF on release. Like a doorbell.
Auto-OFF timerNEW
On a Toggle switch: it comes ON, then turns itself OFF after the time you set. For a bathroom light, a geyser or an exhaust fan nobody remembers to switch off.
Auto-ON timerNEW
The opposite direction: the switch goes OFF, then comes back ON by itself after the time you set. Useful where something must not stay off — a pump, a fridge circuit, a corridor light.
Max pressNEW
On a Push switch: the press is released automatically after the time you set, even if the button is still held down. A safety cap for motors, shutters and gates.
Configure via: Configure Settings Gear Switch Type, then tap the timer chip to set the time.
These timers run on the switch itself. Once set, the countdown lives in the device, not in the app or on our servers — so it still works if your internet is down, your phone is off, or the app is closed. A scheduled Timer is a different feature: that one is a list of dated rules.
Changing the switch type needs a user role with permission to configure the device; a guest or view-only user sees the setting but cannot change it. See Property Type & User Roles.
The switch box lights its own touch panel so you can find it in the dark. How bright that is, is yours to set — full glow in a hallway, barely a glimmer in a bedroom.
On the home page, tap the brightness icon in the header of the device card. (It is replaced by a red Wi-Fi symbol while the device is offline, since the panel cannot be adjusted then.)
Device Touch Panel Light Control opens. Turn the dial, or use − and + for an exact value.
Pick the channel at the bottom of the sheet: White LED, and Green LED on the models that have one.
White can be taken all the way down to off.
Green has a floor — it dims low but never goes fully dark, so the switch stays findable.
Set it by the clock. The alarm tile at the top of the sheet schedules the panel light: dim at bedtime, bright again in the morning, without touching it yourself. The tile shows how many schedules a channel already has.
How long everything has actually been running, and what that costs. Every GSOFT switch box keeps its own ON-time, so this needs no extra meter hardware.
Navigate to: Setting Power Stats
What You See
A period selector — Bi-Monthly (the default, matching a typical electricity bill), Monthly, or Today.
For the period: Total ON time, Energy in kWh, and Est. Cost.
A card per device with its own ON time, energy, and today's figure. Tap it for the switch-by-switch breakdown.
On the detail page, anything running right now carries a green ON 2h 15m badge counting from when it came on.
Making the Numbers Real
Set Tariff Rate (₹/kWh) on the main page — take it from your electricity bill.
On each switch's detail row, tap Set Wattage and enter what the appliance draws.
Energy and cost are estimates. They are calculated as the wattage you entered multiplied by measured ON time — accurate for a fixed load such as a lamp or a geyser, approximate for anything that varies with speed or temperature. For measured consumption, use an Energy Meter device. Switches with no wattage set still show ON time, just no kWh.
Measured consumption, for installations where an estimate is not enough. A GSOFT energy meter appears on the home page as a live readings panel instead of a switch grid, and opening it gives a dashboard rather than the usual device page.
Model
Readings on the home card
VIF-1PH Single phase — homes, shops
Voltage (V), Current (A), live kW, Frequency (Hz), and total kWh.
VIF-3PH Three phase — industrial
Line voltages V_RY / V_YB / V_BR, per-phase currents I_R / I_Y / I_B, live kVA, PF, kWh, kVAh, kVARh, MD kVA (maximum demand), Hz, and run hours.
The Dashboard NEW
Alerts at the top when something is off: low power factor, voltage above or below range, or load approaching the rated kVA. Dismiss one and it stays dismissed until the condition returns.
A gauge of the running load against the meter's rated capacity, with power factor and the time of the last reading.
Daily, Monthly and Total kWh, each with its cost.
An Operating Data chart of consumption by Day, Month, Year, or Lifetime.
Tariff settings — unit price and tax % — which is what turns the kWh figures into currency.
A meter device has the same User tab as any other device, so roles and access periods work on it exactly as they do on a switch box.
For developers, integrators, or power users who want to control GSOFT devices programmatically (Python scripts, custom dashboards, IFTTT-style automations). The Developer API Token authenticates HTTP / WebSocket calls as your account, without your password.
Tokens now expire. When you generate one you choose a validity window — valid from, valid until — with presets for 30 days, 90 days and 1 year, and 90 days chosen by default. Outside that window the token simply stops working. Previously a token lasted until somebody remembered to revoke it, which meant a forgotten key stayed live indefinitely. Tokens issued before this change keep working; regenerate to put a window on them.
Generate Your Token
Open the GSOFT app and tap your profile icon at the top right.
Select Developer API Token.
Enter your account password to verify.
Tap Generate Token, then set how long it should live — Valid from and Valid to, with one-tap presets for 30 days, 90 days and 1 year.
Confirm. A 32-character hex token is created and displayed.
Copy the token now — it's shown in full only at generation time.
What You Can Do With the Token
Authenticate to the GSOFT API as your user.
Read device state, switch state, sensor values.
Send switch ON/OFF, fan speed, and timer commands programmatically.
Build custom dashboards, home automation bridges, or scripts.
Security Notes
The token grants the same access as your login. Treat it like a password.
If the token is exposed, tap Revoke on the same screen — all integrations using it will stop immediately.
Tapping Generate again replaces (regenerates) the token; the old one stops working.
The app shows when the token was created, when it was last used, and the dates it is valid between, so you can audit it.
Set a reminder before the end date. An expired token fails the same way a wrong one does, and an integration that stops overnight is usually an expiry, not a bug.
For Python SDK examples, REST endpoint reference, and message formats, see the developer integration docs (request via Contact Us).
3
Help & Support
Troubleshooting common issues, warranty terms, and how to reach us if you need a hand.