Skip to content

WinTer1165/Messenger-Desktop-Client-Unofficial

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

24 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Messenger Desktop Client (Unofficial)

Messenger Desktop Icon

A Beautiful, Secure Desktop Client for Facebook Messenger

Chat with your friends and family in a dedicated desktop app with premium themes and enhanced privacy

License: MIT Windows

โฌ‡๏ธ Download โ€ข ๐Ÿš€ Installation โ€ข โœจ Features โ€ข ๐Ÿ”’ Security โ€ข ๐Ÿ’ก How to Use


๐Ÿ“ฅ Download

Latest Version: 1.2.0

Choose the version that matches your system:

๐Ÿ”น Windows Installer (Recommended)

Perfect for most users - automatic installation with shortcuts

Download Installer

  • File: Messenger-Desktop-Setup-1.2.0-Windows-x64.exe
  • Size: 185 MB
  • For: Windows 10/11 (64-bit Intel/AMD)
  • Includes: Auto-installer, desktop shortcut, start menu entry

๐Ÿ”น Portable Version - x64 (Intel/AMD)

No installation required - extract and run

Download Portable x64

  • File: Messenger-Desktop-1.2.0-Portable-x64.zip (from releases)
  • For: Windows 10/11 (64-bit Intel/AMD processors)
  • How to use: Extract โ†’ Run Messenger Desktop (Unofficial).exe

๐Ÿ”น Portable Version - ARM64

For Windows on ARM devices (Surface Pro X, etc.)

Download Portable ARM64

  • File: Messenger-Desktop-1.2.0-Portable-ARM64.zip (from releases)
  • For: Windows 10/11 on ARM64 processors
  • How to use: Extract โ†’ Run Messenger Desktop (Unofficial).exe

๐Ÿ“‹ System Requirements

Component Requirement
OS Windows 10 (1809+) or Windows 11
Processor x64 (Intel/AMD) or ARM64
RAM 2 GB minimum, 4 GB recommended
Disk Space 300 MB free space
Internet Required for messaging

โ“ Which Version Should I Download?

  • ๐Ÿ  Home User? โ†’ Download the Installer (easiest)
  • ๐Ÿ’ผ Work Computer (can't install)? โ†’ Use Portable x64
  • ๐Ÿ“ฑ Surface Pro X or ARM device? โ†’ Use Portable ARM64
  • ๐ŸŽฎ Want latest features? โ†’ Check Releases for beta versions

๐Ÿš€ Installation

Option 1: Using the Installer (Recommended)

Step 1: Download

Download the installer from above or visit Releases

Step 2: Run the Installer

  1. Open the downloaded file - Double-click Messenger-Desktop-Setup-1.2.0-Windows-x64.exe

  2. Windows Security Warning (Normal for unsigned apps):

    • If you see "Windows protected your PC":
    • Click More info
    • Click Run anyway
    • This is safe - the app is open source and not code-signed
  3. Follow the installer - Click through the installation wizard

  4. Launch the app - It will open automatically after installation


Option 2: Using Portable Version

For x64 (Intel/AMD) or ARM64

  1. Download the appropriate portable version from above
  2. Extract the zip file to a folder (e.g., C:\Apps\Messenger)
  3. Run Messenger Desktop (Unofficial).exe
  4. Optional: Create a desktop shortcut manually

Note: Portable versions don't require installation but don't create Start Menu entries automatically.


First-Time Login (All Versions)

After launching the app for the first time:

  1. Facebook Login Page opens automatically
  2. Enter your credentials - Log in with your Facebook account
  3. Wait for confirmation - App detects successful login via session cookies
  4. Automatic redirect - You'll be redirected to Messenger in ~3 seconds
  5. Done! - Future launches go directly to Messenger

Privacy Note: Your credentials are sent directly to Facebook, not stored by this app. The app only stores a session cookie, just like a web browser.


โœจ Features

๐Ÿš€ Smart First-Time Login

  • Seamless Facebook authentication on first launch
  • Automatic session detection via secure cookies
  • Auto-redirect to Messenger after successful login
  • Persistent login - no need to sign in again
  • Direct credential submission to Facebook (never stored locally)

๐ŸŽจ Premium Themes

Transform your Messenger with stunning color themes that apply everywhere.

Themes apply to: Main window, title bar, video calls, and audio calls!

๐ŸชŸ Custom Title Bar

  • Minimalistic pixelated Messenger logo
  • Native window controls (minimize, maximize, close)
  • One-click theme switching with palette icon
  • Minimize to Tray toggle - Choose behavior on window close
  • Smooth gradient backgrounds matching your theme
  • About button with GitHub project link

๐Ÿ“ž Enhanced Communication

  • โœ… Full audio and video call support
  • โœ… Screen sharing with intuitive picker (entire screen or specific window)
  • โœ… Call windows inherit your chosen theme
  • โœ… Custom Messenger icon for all windows
  • โœ… Multiple call windows supported

๐Ÿ–ฅ๏ธ System Integration

  • ๐Ÿ“ฎ System tray icon with live unread counter
  • ๐Ÿ’พ Window state memory (size, position, maximized state)
  • ๐ŸŽ›๏ธ Configurable minimize-to-tray behavior

๐Ÿ”’ Security & Privacy

Why This App is Safe

โœ… Open Source - All code is public and auditable on GitHub

โœ… No Data Collection - Zero tracking, analytics, or data harvesting

โœ… Sandboxed - Web content runs in an isolated, secure container

โœ… Direct to Facebook - Credentials go straight to Facebook's servers

โœ… Session-Only Storage - Only saves your login session (like a browser)

โœ… No Third-Party Services - No external dependencies or cloud services

Security Features

๐Ÿ›ก๏ธ Context Isolation - Prevents malicious code from accessing system APIs

๐Ÿ›ก๏ธ Content Security Policy - Blocks XSS and injection attacks

๐Ÿ›ก๏ธ Rate Limiting - Protects against message flooding

๐Ÿ›ก๏ธ Input Validation - All internal messages are validated

๐Ÿ›ก๏ธ Navigation Control - Only messenger.com and Facebook domains allowed

What Data is Stored Locally?

The app stores these files on your computer:

C:\Users\YourName\AppData\Roaming\messenger-desktop-unofficial\
โ”œโ”€โ”€ config.json          (Your theme preference, minimize-to-tray setting)
โ””โ”€โ”€ window-state.json    (Window size and position)

That's it! No chat logs, no passwords, no personal data.


๐ŸŽจ Themes

Transform your Messenger experience with 6 stunning themes!

How to Change Themes

  1. Look at the title bar (top of the window)
  2. Click the ๐ŸŽจ palette icon (next to minimize button)
  3. Theme cycles through all 6 options
  4. Your choice is saved automatically

Available Themes

๐ŸŽจ Theme Perfect For
๐ŸŒ™ Dark Night usage, less eye strain
โ˜€๏ธ Light Daytime, bright environments
๐ŸŒฒ Lush Forest Relaxation, focus
โšซ Contrast Maximum readability
๐Ÿœ๏ธ Desert Cozy atmosphere
โšก Electric Bold, energetic feel

Note: Your theme applies to everything - title bar, chat background, and even video call windows!


๐Ÿ’ก How to Use

System Tray

The app sits in your system tray (bottom-right corner of Windows taskbar):

  • Single click - Show/hide the window
  • Right click - Open menu with options:
    • Show Messenger
    • Quit

Minimize to Tray Toggle

Choose what happens when you click the X button:

  1. Look for the tray icon ๐Ÿ“ฅ in the title bar (next to themes)
  2. Click to toggle:
    • Blue/Active = Window minimizes to tray (stays running)
    • Gray/Inactive = App completely quits
  3. Your choice is saved automatically

Video Calls & Screen Sharing

  1. Start a call - Click video/audio call button in Messenger
  2. Screen share - Click share screen button in the call window
  3. Choose what to share:
    • ๐Ÿ–ฅ๏ธ Entire Screen - Share everything
    • ๐ŸชŸ Specific Window - Share just one app
  4. Click to select - Start sharing!

โ“ FAQ (Frequently Asked Questions)

Is this safe to use?

Yes! The app is completely open source (all code is visible on GitHub). It doesn't collect any data, doesn't store your password, and only saves your login session cookie - exactly like using Messenger in a web browser.

Do I need to log in every time?

No! After your first login, the app remembers your session. You'll stay logged in until you manually log out.

Can I use multiple accounts?

Not currently. You'll need to log out and log back in to switch accounts. Multi-account support may come in a future update!

Why does Windows show a security warning?

The app is not "code signed" (a digital signature that costs $300+/year). This is normal for free open-source software. Click "More info" โ†’ "Run anyway" to install.

Will my messages be private?

Absolutely! This app is just a window to messenger.com - your messages go directly to Facebook's servers, exactly like using Messenger in Chrome or Edge. The app doesn't read, store, or send your messages anywhere else.

Does this work with Messenger Kids or Business?

This app is designed for personal Facebook Messenger accounts only.

Can I use this on Mac or Linux?

Not yet - currently Windows only. Mac and Linux support is planned for future releases!

How do I uninstall?

Go to Windows Settings โ†’ Apps โ†’ Find "Messenger Desktop (Unofficial)" โ†’ Click Uninstall


๐Ÿ› ๏ธ Troubleshooting

๐Ÿ”ด Problem: "Windows protected your PC" warning

Solution:

  1. Click "More info"
  2. Click "Run anyway"
  3. This is normal for unsigned apps - the app is safe (open source code)

๐Ÿ”ด Problem: App won't start or crashes immediately

Solution 1: Restart your computer Solution 2: Uninstall and reinstall:

  1. Windows Settings โ†’ Apps โ†’ Uninstall
  2. Download fresh installer
  3. Install again

๐Ÿ”ด Problem: Can't log in / Login page won't load

Solution:

  1. Check your internet connection
  2. Try restarting the app
  3. If still not working, check if Facebook.com works in your web browser
  4. Make sure you're not behind a firewall blocking Facebook

๐Ÿ”ด Problem: Video calls not working

Solution:

  1. Allow camera/microphone permissions:
    • Look for permission popup from Windows
    • Click "Allow"
  2. Check Windows Settings โ†’ Privacy โ†’ Camera & Microphone
  3. Make sure Messenger Desktop is allowed

๐Ÿ”ด Problem: Screen sharing not working

Solution:

  1. Restart the app
  2. Make sure you have Windows 10 version 1809 or newer
  3. Try sharing a specific window instead of entire screen

๐Ÿ”ด Problem: Theme not changing

Solution:

  1. Try clicking the palette icon multiple times
  2. Restart the app - your theme should be remembered
  3. If still broken, reinstall the app

๐Ÿ”ด Problem: App running slow

Solution:

  1. Close and reopen the app (File โ†’ Quit)
  2. Check Task Manager - close other heavy apps
  3. Try the "Contrast" theme (uses less resources)

Still having issues?

Open an issue on GitHub with:

  • What went wrong
  • What you tried
  • Screenshots (if applicable)

๐Ÿ“Š Reliability & Performance

App Performance

โœ… Lightweight - Uses ~150-450 MB RAM (similar to a browser tab)

โœ… Fast Startup - Launches in 2-3 seconds

โœ… Stable - Built on Electron 38 (same tech as VS Code, Discord, Slack)

โœ… Updates - Manual updates when new versions are released

Connection Reliability

โœ… Always Online - Stays connected as long as you have internet

โœ… Auto-Reconnect - Automatically reconnects if the connection drops

โœ… Offline Mode - Shows connection status


๐Ÿ‘จโ€๐Ÿ’ป For Developers

Quick Build

# Clone repo
git clone https://github.com/WinTer1165/Messenger-Desktop-Client-Unofficial.git
cd Messenger-Desktop-Client-Unofficial

# Install dependencies
npm install

# Build
npm run build

# Run
npm start

# Build installer
npm run dist:win

๐Ÿค Contributing

Contributions are welcome! Here's how you can help:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Please ensure:

  • Code passes npm test
  • TypeScript types are properly defined
  • No security vulnerabilities are introduced
  • Features are documented in the README

๐Ÿ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.


๐Ÿ’ฌ Support & Community

Need help or want to chat?


โš ๏ธ Important Disclaimer

This is an unofficial desktop client for Facebook Messenger.

Not affiliated with, endorsed by, or connected to Meta/Facebook.

This project is open source (MIT License) and provided as-is for personal use.

Facebookยฎ and Messengerยฎ are registered trademarks of Meta Platforms, Inc.

Hits