USER GUIDE - nself-org/nchat GitHub Wiki
Version: 1.0.0 Welcome to ɳChat - Modern team communication made simple.
- Getting Started
- Creating Your Account
- Channels
- Messaging
- Voice & Video Calls
- File Sharing
- Reactions & Threads
- Search & Discovery
- Notifications
- Settings & Preferences
- Keyboard Shortcuts
- Mobile Apps
- Tips & Tricks
- Troubleshooting
ɳChat is a modern team communication platform that combines the best features of Slack, Discord, Telegram, and Signal. Built with security and performance in mind, ɳChat provides:
- Real-time messaging with rich text formatting
- Voice and video calls with crystal-clear quality
- End-to-end encryption for private conversations
- File sharing with preview support
- Powerful search to find anything instantly
- Multi-platform support (web, desktop, mobile)
Web Browser:
- Chrome 90+
- Firefox 88+
- Safari 14+
- Edge 90+
Desktop App:
- Windows 10/11
- macOS 11+
- Linux (Ubuntu 20.04+, Fedora 34+)
Mobile App:
- iOS 14+
- Android 8.0+
- Visit your ɳChat instance URL (e.g.,
https://chat.yourcompany.com) - Click "Sign Up" or "Create Account"
- Enter your information:
- Email address
- Password (8+ characters, including uppercase, lowercase, number, special character)
- Display name
- Verify your email (check your inbox)
- Complete your profile (optional but recommended)
- Go to your ɳChat URL
- Enter your email and password
- Click "Sign In"
- Optional: Enable "Remember me" for quick access
After signing in, complete your profile:
- Click your avatar in the top-right corner
- Select "Profile Settings"
- Add:
- Profile photo
- Display name
- Bio/status
- Time zone
- Click "Save Changes"
Channels are organized spaces for team communication. Think of them as chat rooms focused on specific topics, projects, or teams.
- Public Channels (#general, #random): Anyone can join and see messages
- Private Channels (🔒 secret-project): Invite-only, hidden from non-members
- Direct Messages (DMs): One-on-one conversations
- Group DMs: Private conversations with multiple people
- Click the "+" button next to "Channels" in the sidebar
- Choose channel type (public or private)
- Enter channel details:
- Name (e.g., "general", "engineering", "marketing")
- Description
- Add members (for private channels)
- Click "Create Channel"
Channel Naming Tips:
- Use lowercase
- Use hyphens for spaces (e.g., "project-alpha")
- Keep names short and descriptive
- Use prefixes for organization (e.g., "team-", "proj-")
Public Channels:
- Click "Browse Channels" in the sidebar
- Find the channel you want
- Click "Join"
Private Channels:
- You must be invited by a channel member or admin
Channel admins can:
- Edit channel name and description
- Manage members (add/remove)
- Set channel permissions
- Archive or delete the channel
To access channel settings:
- Open the channel
- Click the channel name at the top
- Select "Channel Settings"
- Select a channel or DM
- Type your message in the input box at the bottom
- Press Enter to send (or Shift+Enter for new line)
Use markdown-style formatting:
**Bold text** → Bold text
*Italic text* → Italic text
~~Strikethrough~~ → Strikethrough
`Code` → Inline code
```Block code``` → Code block
> Quote → Blockquote
- List item → Bullet list
1. Numbered item → Numbered list
Mention a user:
@username
The user will receive a notification.
Mention everyone in a channel:
@channel
Use sparingly! This notifies all channel members.
Mention here (online users only):
@here
Notifies only users currently online.
Edit a message:
- Hover over your message
- Click the ⋯ (more) button
- Select "Edit"
- Make changes and press Enter
Delete a message:
- Hover over your message
- Click the ⋯ (more) button
- Select "Delete"
- Confirm deletion
Note: Edited messages show an "edited" indicator
Send messages at a specific time:
- Type your message
- Click the ⏰ Schedule button
- Choose date and time
- Click "Schedule Message"
View scheduled messages:
- Click your profile → "Scheduled Messages"
Forward messages to other channels:
- Hover over the message
- Click ⋯ → "Forward"
- Select destination channel(s)
- Add optional comment
- Click "Forward"
Voice Call:
- Open a DM or channel
- Click the 📞 Call button
- Wait for others to join
Video Call:
- Open a DM or channel
- Click the 📹 Video button
- Allow camera/microphone permissions
- Wait for others to join
While on a call:
- 🎤 Mute/Unmute: Toggle your microphone
- 📹 Video On/Off: Toggle your camera
- 🖥️ Share Screen: Share your screen with participants
- ⚙️ Settings: Adjust audio/video settings
- 📞 End Call: Leave the call
- Click 🖥️ Share Screen during a call
- Choose what to share:
- Entire screen
- Application window
- Browser tab
- Click "Share"
For best call quality:
- Use a wired internet connection (Ethernet)
- Close unnecessary applications
- Use headphones to prevent echo
- Ensure good lighting for video calls
- Test your audio/video in Settings → Audio & Video
Drag & Drop:
- Drag files into the message input
- Files will be uploaded automatically
Click to Upload:
- Click the 📎 (attach) button
- Select files from your computer
- Files will be uploaded
Supported File Types:
- Images: JPG, PNG, GIF, WebP, SVG
- Videos: MP4, WebM, MOV
- Audio: MP3, WAV, OGG
- Documents: PDF, DOC, DOCX, XLS, XLSX, TXT, CSV
- Max file size: 100MB
ɳChat automatically generates previews for:
- Images: Inline display with zoom
- Videos: Inline player
- PDFs: Document viewer
- Code files: Syntax-highlighted preview
- Click the file in a message
- Click the ⬇️ Download button
- File saves to your Downloads folder
React to messages with emojis:
- Hover over a message
- Click the 😀 emoji icon
- Select an emoji from the picker
- Or type
:emoji_name:and press Enter
Popular shortcuts:
- 👍
:thumbsup: - ❤️
:heart: - 😂
:laughing: - 🎉
:tada: - ✅
:white_check_mark:
Keep conversations organized with threads:
Start a thread:
- Hover over a message
- Click 💬 Reply in thread
- Type your reply
View threads:
- Click "Threads" in the sidebar to see all your threads
Thread notifications:
- Get notified when someone replies to a thread you're in
Quick search:
- Press Cmd/Ctrl + K
- Type your search query
- Press Enter
Advanced search:
- Use the search bar at the top
- Apply filters:
-
from:@username- Messages from a specific user -
in:#channel- Messages in a specific channel -
has:file- Messages with attachments -
has:link- Messages with links -
before:2026-01-01- Messages before a date -
after:2026-01-01- Messages after a date
-
Examples:
project alpha from:@john
meeting notes in:#general has:file
budget in:#finance after:2026-01-01
- Click "Browse Channels" in the sidebar
- Use the search bar to filter
- Click a channel to view details
- Click "Join" to join
- Press Cmd/Ctrl + K
- Start typing a name
- Click the person to open a DM
Global settings:
- Click your profile → "Settings"
- Go to "Notifications"
- Configure:
- Desktop notifications
- Email notifications
- Push notifications (mobile)
- Notification sounds
Per-channel settings:
- Open the channel
- Click the channel name
- Select "Notification Preferences"
- Choose:
- All messages: Get notified for every message
- Mentions only: Only @mentions and keywords
- Nothing: Mute the channel
Pause notifications temporarily:
- Click your profile
- Select "Set status"
- Choose "Do Not Disturb"
- Set duration (30 min, 1 hour, custom)
Get notified when specific words are mentioned:
- Go to Settings → Notifications
- Add "Notification Keywords"
- Enter words (e.g., "urgent", "help", your name)
- Save changes
- Display name: How others see you
- Avatar: Your profile picture
- Status: Custom status message
- Bio: About yourself
- Theme: Light, Dark, or System
- Message density: Comfortable or Compact
- Font size: Small, Medium, or Large
- Sidebar: Collapsed or Expanded by default
- Online status: Show/hide when you're online
- Read receipts: Show/hide when you've read messages
- Typing indicators: Show/hide when you're typing
- Profile visibility: Public or Team-only
- High contrast mode: Better visibility
- Screen reader support: Enhanced for screen readers
- Keyboard navigation: Full keyboard control
- Reduce motion: Disable animations
| Action | Windows/Linux | Mac |
|---|---|---|
| Quick switcher | Ctrl + K | Cmd + K |
| Search | Ctrl + F | Cmd + F |
| New message | Ctrl + N | Cmd + N |
| Mark as read | Esc | Esc |
| Previous channel | Alt + ↑ | Opt + ↑ |
| Next channel | Alt + ↓ | Opt + ↓ |
| Action | Windows/Linux | Mac |
|---|---|---|
| Send message | Enter | Enter |
| New line | Shift + Enter | Shift + Enter |
| Edit last message | ↑ (in empty input) | ↑ (in empty input) |
| Add reaction | Ctrl + Shift + \ | Cmd + Shift + \ |
| Reply in thread | Ctrl + Shift + T | Cmd + Shift + T |
| Action | Windows/Linux | Mac |
|---|---|---|
| Bold | Ctrl + B | Cmd + B |
| Italic | Ctrl + I | Cmd + I |
| Strikethrough | Ctrl + Shift + X | Cmd + Shift + X |
| Code | Ctrl + E | Cmd + E |
| Link | Ctrl + Shift + U | Cmd + Shift + U |
| Action | Shortcut |
|---|---|
| Mute/Unmute | Ctrl/Cmd + D |
| Video On/Off | Ctrl/Cmd + E |
| Share Screen | Ctrl/Cmd + Shift + E |
| End Call | Ctrl/Cmd + Shift + H |
iOS:
- Open the App Store
- Search for "ɳChat" or your company's custom app
- Tap "Get" → "Install"
- Open the app and sign in
Android:
- Open the Google Play Store
- Search for "ɳChat" or your company's custom app
- Tap "Install"
- Open the app and sign in
- Push notifications: Get notified instantly
- Biometric authentication: Use Face ID/Touch ID/Fingerprint
- Share from other apps: Share files, photos, links to ɳChat
- Camera: Take photos/videos directly in the app
- Voice messages: Record and send voice messages
- Offline mode: Read messages without internet
- Swipe gestures: Swipe right on a message to reply
- Long press: Long press a message for quick actions
- Pull to refresh: Pull down to refresh messages
- Search: Use the search icon to find anything
- Use channels strategically: Create focused channels for projects
- Set status: Let teammates know when you're busy
- Star important channels: Keep them at the top of your sidebar
- Use threads: Keep side conversations organized
- Mute noisy channels: Stay focused on what matters
- Schedule messages: Send at the right time, even when offline
- Use keyboard shortcuts: Navigate faster
- @mention sparingly: Don't overuse @channel or @here
- Use reactions: Quick way to acknowledge messages
- Keep messages concise: Short messages are easier to read
- Use code blocks: For sharing code or logs
- Share files with context: Add a message explaining the file
- Create polls: Get quick team feedback
- Use video calls: For complex discussions
- Name channels clearly: Use consistent naming conventions
- Pin important messages: Keep key information accessible
- Archive old channels: Keep your sidebar clean
- Use channel descriptions: Help new members understand the purpose
- Create welcome channels: Onboard new team members
- Document decisions: Keep a #decisions channel
Problem: Can't connect to ɳChat
Solutions:
- Check your internet connection
- Try refreshing the page (Ctrl/Cmd + R)
- Clear browser cache and cookies
- Try a different browser
- Check if your firewall is blocking ɳChat
Problem: Not receiving notifications
Solutions:
- Check notification settings in ɳChat
- Check browser notification permissions
- Check OS notification settings
- Disable Do Not Disturb mode
- Try logging out and back in
Problem: Poor audio/video quality
Solutions:
- Check your internet speed (need 1+ Mbps)
- Close other bandwidth-heavy applications
- Switch from Wi-Fi to Ethernet
- Reduce number of participants
- Turn off video to save bandwidth
Problem: Can't upload files
Solutions:
- Check file size (max 100MB)
- Check file type (see supported types)
- Try a different browser
- Clear browser cache
- Check your internet connection
Problem: App crashes or freezes
Solutions:
- Force quit and reopen the app
- Update to the latest version
- Clear app cache (in app settings)
- Restart your device
- Reinstall the app
- Help Center: https://help.nchat.example.com
- Video Tutorials: https://nchat.example.com/tutorials
- Community Forum: https://community.nchat.example.com
- Email Support: [email protected]
We love hearing from you!
- Feature Requests: https://feedback.nchat.example.com
- Bug Reports: [email protected]
- General Feedback: [email protected]
You're all set to start collaborating with your team. If you have any questions, don't hesitate to reach out to support.
Happy chatting!
Last Updated: January 29, 2026 Version: 1.0.0