ms365-electron/README.md

Unofficial Microsoft 365 Web Desktop Wrapper made with Electron

Table of contents

• Table of contents
• Introduction
• Windows
  • 💿 Installation on Windows
  • 📸 Windows Preview
• macOS
  • 💿 Installation on macOS
• Linux
  • 💿 Installation on Linux
    • Installation on Ubuntu/Debian based distributions
    • Installation on Red Hat/Fedora based distributions
    • Installation on Arch/Manjaro Linux based distributions
    • Installation on Gentoo Linux
  • 📸 Ubuntu Preview
• 💻 Developing Locally
• 📃 MIT License - Disclaimer: Not affiliated with Microsoft. Office, the name, website, images/icons are the intellectual properties of Microsoft.

Introduction

This project is basically a Desktop wrapper for the web version of Microsoft 365, which is free but with some basic limits.

I initially made this project because I wanted to use Microsoft 365 on my Linux system with a native experience. Later, I decided to make it public so that others can enjoy this too!

Don't expect this to be a full-fledged Microsoft 365 Desktop Suite (like we have for Windows/macOS), it's just a wrapper of the web version of Microsoft 365.

Note - Windows Hello or Sign in with Security key is not supported and will show you an error. You will have to manually sign in with your E-Mail and Password.

Do Expect bugs

Supported Platforms

1. Windows x64 (EXE File)
2. macOS x64 (DMG File)
3. Ubuntu/Debian based distributions (DEB File)
4. Red Hat Linux/Fedora based distributions (RPM File)
5. Arch/Manjaro Linux based distributions (Uploaded on AUR)
6. Gentoo Linux (Unofficial overlay)
7. All Distributions supporting AppImage (AppImage File); and
8. All Distributions supporting Snap (Uploaded on Snap Store)

Windows

💿 Installation on Windows

For Installing this app on Windows:

1. Just go to the Releases page
2. Scroll down and click the MS-365-Electron-vx.x.x-win-x64.exe file. The Setup file will start downloading.
3. After it downloads, click on the file and proceed with the Installation. You can choose whether to install for only you or all the users on the PC. You can always start the app from Start Menu or from the Desktop Shortcut.

📸 Windows Preview

Click Here

macOS

💿 Installation on macOS

For Installing this app on Mac :-

1. Just go to the Releases page
2. Scroll down and click the .dmg file. The build is only for Intel Macs.
3. After it downloads, click on the file and mount it on your system. Now drag my app to the Applications Folder (There will be a shortcut in the opened window too) and your app will be installed. Open from Launchpad and enjoy.

Linux

💿 Installation on Linux

Installation on Ubuntu/Debian based distributions

For Installing in Ubuntu/Debian based distribution :-

1. Go to the Releases page
2. Scroll down and click the .deb file to download it.
3. Then run the deb file and click Install to install the App. Launch it from the Applications Menu.

Installation on Red Hat/Fedora based distributions

For Installing in Red Hat/Fedora based distribution :-

1. Go to the Releases page
2. Scroll down and click the .rpm file to download it.
3. Then run the rpm file and click Install to install the App. Launch it from the Applications Menu.

Installation on Arch/Manjaro Linux based distributions

1. Install any AUR helper like yay

2. There are 2 packages in the AUR

   • ms-office-electron-bin: For installing pre-built releases
   • ms-office-electron-git: For building the app from source and installing.

3. Now, for example, using yay, run:

   yay -Sy ms-office-electron-*
   

   To install the package accordingly.

4. Wait for it to install and tada! The app is installed.

Installation on Gentoo Linux

1. This is supported by an ebuild uploaded on my unofficial overlay. First, enable the overlay on your system:

   eselect repository add agam778-overlay git https://github.com/agam778/agam778-overlay.git
   emaint sync -r agam778-overlay
   

2. Now, install the package:

   sudo emerge -a ms-office-electron
   

📸 Ubuntu Preview

Click Here

💻 Developing Locally

To build the app locally:
Run this script to automatically install nodejs, yarn and all the dependencies, and automatically start/build the app (it will show options) (Note: for Linux and macOS Only!):

git clone https://github.com/agam778/MS-365-Electron.git
cd MS-365-Electron
bash build.sh

Or:
Run the following commands to clone the repository and install the dependencies

git clone https://github.com/agam778/MS-365-Electron.git
cd MS-365-Electron
yarn install

$ yarn run
yarn run v1.22.18
info Commands available from binary scripts: asar, dircompare, ejs, electron, electron-builder, electron-osx-flat, electron-osx-sign, extract-zip, install-app-deps, is-ci, jake, js-yaml, json5, mime, mkdirp, node-which, rc, rimraf, semver
info Project commands
   - dist
      electron-builder
   - pack
      electron-builder --dir
   - start
      electron .
question Which command would you like to run?:

To start the app, run yarn start
To build the app, run yarn dist

📃 MIT License

Disclaimer: Not affiliated with Microsoft. Office, the name, website, images/icons are the intellectual properties of Microsoft.