Skip to content

VladimirMikulic/visum

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

7 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Visum

In-browser Office files viewer for Linux.


Version Open Source Love License: MIT Twitter: VladoDev

πŸ”₯ Why Visum?

Visum was created to solve the problem of viewing office files on Linux the right way.

The problem with Microsoft Office alternatives for Linux is that they are unusable for various reasons. Libre Office has a dreaded design from the 90s, WPS needs font patching, installations result in unresolved dependencies, partial Windows Office files compatibility, and the list goes on...

It's frustrating to install +500Mb office, patch its numerous errors only to find out that it even can't correctly display your document. You switch to another distro, and you go through this again.

Visum is different because it uses Microsoft Office Online version to display your files, so you can be sure that your files are displayed correctly. No more missing text, inverted colours, distorted shapes etc. Visum is very lightweight as well, only 2 scripts and you are good to go! Suitable for everyone, from hobbyist distro hoppers & developers, all the way to students and non-techies.

Benefits of using Visum:

  • πŸš€ Blazingly fast

  • πŸ”Œ Customizable

  • ⚑ Built on pre-installed technologies

  • πŸ’» Lightweight to install

  • 🚫 NO need for an online account

πŸ“¦ Installation

⚠️ Before installing Visum, make sure that you have public SSH key. To generate one, visit this link.

Install Visum by running these commands:

# Clone the repo
git clone https://github.com/VladimirMikulic/visum.git
# Make installer executable
chmod +x visum/install.sh
# Run the installer
./visum/install.sh

Freedom to choose!

Visum gives you freedom to select the Office of your choice!

  • Google's Office
  • Microsoft's Office

By default, your Office files will be opened in Microsoft Office in your default browser.

You can switch Office Suites by opening and modifying Visum config file ~/.config/visum/visum.conf.

To use Google's Office modify VISUM_PREFERRED_OFFICE like this:

VISUM_PREFERRED_OFFICE=GOOGLE_OFFICE

To switch back to Microsoft's Office:

VISUM_PREFERRED_OFFICE=MICROSOFT_OFFICE

That's it! Now you can view Office files in your browser! πŸŽ‰

☁️ Usage

Watch Visum in action! Simply double-click a file on the desktop!

Visum Excel

πŸ”οΈ CLI

You can use Visum in CLI by adding this code to your ~/.bashrc/~/.zshrc file:

visum() {
  bash /usr/share/visum/scripts/visum.sh $1 > /dev/null 2>&1
}

Now, you can run visum <office_file_path> and the file will be opened!

✨ Run tests

Visum uses Python 3 core lib unittest for testing.

Tests can be executed by running:

python3 test/test_visum.py
python3 test/test_server.py

πŸ‘¨ Author

Vladimir Mikulic

🀝 Contributing

Contributions, issues and feature requests are welcome!

🍻 Credits

Logo design inspired by Freepik. ❀️

πŸ“ License

This project is licensed under MIT license.

πŸ‘¨β€πŸš€ Show your support

Give a ⭐️ if this project helped you!