ChatSpace | Client Guide

Getting Started

Downloading & Running

Because ChatSpace is a new Beta, your browser may warn that the file is "not commonly downloaded". You must select Keep or Keep Anyway to finish the download.

Windows SmartScreen:
If Windows says "Unknown Publisher", click More Info → Run Anyway.

Pro Tip:
Right-Click the .exe → Properties → Check "Unblock" at the bottom to ensure smooth operation.

Login & Registration

On the launch screen, use the toggle at the top to switch between Login and Register. New accounts require a valid Captcha code. No email verification is currently needed. Please remember each server has it's own database, so you will need to sign up to each server.

Hub Selection

The client defaults to the official Hub, but you can enter any custom Server IP. Click the dropdown to see known public servers or type 127.0.0.1 for a locally hosted server.

Moving & Navigation

Left-click and drag your avatar to move. To visit a new website, type the URL in the top bar and hit Enter. Use the "LOBBY" button to return to the start.

Power Features

The Right-Click Menu

Right-click on any user (including yourself) to access the Context Menu. This is where you find options to DM, Profile, Trade Files, Link, and Poke.

How much RAM the client uses

The client can use upto 300MBs of RAM. Make sure your system has sufficient RAM or it may lag. We suggest a PC/Laptop with atleast 8-16 gigs of Ram.

Avatar Linking

Want to follow a friend? Right-click them and select Link Person. If they accept, your avatar will automatically follow theirs wherever they move. Right-click yourself to Unlink.

P2P File Transfer

Send files directly to other users without a central server. Right-click a user > Send File. Warning: Only accept files from trusted users.

Webcam & Streaming

Right-click yourself > Start Webcam to broadcast video inside your avatar bubble. Others can right-click you to "Watch Stream" if you are broadcasting content but this feature is currently disabled.

Custom Themes

ChatSpace supports custom themes. Click the THEMES button in the sidebar to load themes from your local /themes folder. Changes apply instantly.

Private Rooms

Click Private Room in the sidebar to create a password-protected instance. Users must be on the same URL and enter the exact same password to see each other.

How to Make a Theme

The ChatSpace Engine uses a powerful JavaScript-based theming system. Themes are .js files that the client watches for live updates—as soon as you save the file, the client updates your visuals instantly.

1. Location

Navigate to the folder where your ChatSpace.exe is located. Open the /themes folder. Any .js file placed here will appear in the Client's Theme Manager.

2. File Structure

Create a new file (e.g., my-theme.js) and paste the following structure: (I've included a PDF in the client folder to explain this more in more detail)

module.exports = {
  name: "My Custom Theme",
  colors: {
    "--bg-dark": "#050505",
    "--bg-panel": "#0e0e10",
    "--primary": "#10b981",
    "--accent": "#06b6d4",
    "--text-main": "#e4e4e7"
  }
};
                

3. Available Variables

You can override any of these variables in the colors object to completely change the look of the client:

--bg-dark (Main background)

--bg-panel (Sidebar & bars)

--bg-lighter (Input fields)

--primary (Green accents)

--secondary (Purple accents)

--accent (Blue/Action accents)

--text-main (Main text color)

--text-dim (Muted text/labels)

--glass (Background for modals)

--danger (Warning/Stop colors)

Troubleshooting

I can't move my avatar!

Ensure you aren't "Linked" to another user. If you are linked, you cannot move independently. Right-click yourself and select "Unlink Avatars". If that fails, click the "LOBBY" button to reset your state.

Images/Avatars aren't loading.

ChatSpace loads images from the host server. If the server is slow or your connection is unstable, images may time out. Try pressing Ctrl + R (Windows) to reload the client interface.

Webcam fails to start.

Ensure no other application (like Zoom or Discord) is currently using your camera. Go to Settings/Themes > Webcam Select to ensure the correct device is chosen. You may need to grant permission in your OS settings.

I see a "Rate Limit" warning.

To prevent spam, the server limits how fast you can type messages. If you trigger this, simply wait 1 seconds before typing again. Repeated violations may result in a temporary mute (Gag).

How do I update?

If you see a "Version Mismatch" error upon connecting, you need to download the latest client from the download page. The client does not currently auto-update.