vladimirmikulic / visum Goto Github PK

View Code? Open in Web Editor NEW

24.0 3.0 4.0 3.84 MB

🔥 In-browser Office files viewer for Linux.

License: MIT License

Python 46.18% Shell 53.82%

in-browser office viewer linux-app documents spreadsheets presentations

visum's Introduction

Visum

In-browser Office files viewer for Linux.

🔥 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!

🏔️ 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

Twitter: @VladoDev
Github: @VladimirMikulic
LinkedIn: @vladimirmikulic

🤝 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!

visum's People

Contributors

Stargazers

Watchers

Forkers

adrienlucbert xichun tlaundal siumk

visum's Issues

Cant work on Arch

Finding this repository is really a surprise to me, but sadly it cant work on my linux. I try to open with Visum in thunar and try to use Firefox and msedge as default browser, both didn't work. When I use Firefox, there is nothing open, while msedge will download my local file.

I also try to use cli and got a 'x-www-browser not found' error.

Btw, msedge has a new feature that can use office view to open office file instead of download it, but i seems not work on linux.(I disable it while testing visum), maybe this feature can be helpful for this project.

Recommended way to uninstall the package?

Failure to open files

I stumbled upon your project while looking for a lightweight .doc viewer (I was not specifically looking for something based on Microsoft Office online, just wanted something lighter than LibreOffice). This looks like a really awesome project, thanks for your work! I really like it. I still have to check if it requires an Internet connection (I guess it does) and what is the CPU use for Microsoft Office online, but I definitely want to have this installed on my computer.

However, I'm facing an issue opening files right now. I installed visum using the install script and associated files are now in /usr/share as they should, but nothing happens when I try to open a file from a GUI file browser with visum. Same from command line: I noticed that /usr/share/visum/scripts/visum.sh is not executable, but if I cd /usr/share/visum and then run it with sh scripts/visum.sh path/to/file.doc, I get this:

/usr/share/visum $ sh scripts/visum.sh /path/to/file.doc
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100    15  100    15    0     0    258      0 --:--:-- --:--:-- --:--:--   258
kill: usage: kill [-s sigspec | -n signum | -sigspec] pid | jobspec ... or kill -l [sigspec]
scripts/visum.sh: command substitution: line 46: syntax error near unexpected token `('
scripts/visum.sh: command substitution: line 46: `comm -23 <(seq 49152 65535 | sort) <(ss -Htan | awk '{print $4}' | cut -d':' -f2 | sort -u) | shuf | head -n 1'
Bad remote forwarding specification 'vu8QnGxX90:80:localhost:'

Other than that, I find it a bit weird that install.sh moves everything clone from git to /usr/share/visum, including files that are probably not needed to execute visum. I would expect that only mandatory files for execution would be moved there, while other files (LICENSE.md, install.sh, etc.) would stay in the git folder.

is it not working anymore?

Hi there. it should be a gread helper. I am so tired of the slow LibreOffice.

but after installation, office online shows 404 and google doc says No preview available

am I missing something or it is not working anymore?

Installation issue

following the steps outlined leads to the following output:

===============================================================
gareth@kali:$ git clone https://github.com/VladimirMikulic/visum.git
Cloning into 'visum'...
remote: Enumerating objects: 30, done.
remote: Counting objects: 100% (30/30), done.
remote: Compressing objects: 100% (22/22), done.
remote: Total 30 (delta 7), reused 30 (delta 7), pack-reused 0
Unpacking objects: 100% (30/30), 3.83 MiB | 1.17 MiB/s, done.
gareth@kali:$ chmod +x visum/install.sh
gareth@kali:~$ ./visum/install.sh
Installing Visum...
Dependencies satisfied.
[sudo] password for gareth:
cp: cannot stat './scripts': No such file or directory
cp: cannot stat './media': No such file or directory
cp: cannot stat './visum.desktop': No such file or directory

Done! Enjoy Visum :)
gareth@kali:~$

==============================================================

Program will not then run.
"cp: cannot stat" normally relates to paths with spaces or special characters but cannot see how this applies in this case.

I am not a programmer and only have a tenuous grasp of the command line and linux file systems.

regards

Gareth

Visum not working

Installed and then edited the config file, but nothing happens when i try to open a .xlsx file.

file not found errors

Neither Microsoft nor Google visualizer worked. Made a normal installation and opened some files under my home directory. Looks like they can't access the files.

I'm on Pop OS 20.04 LTS, and Chrome 92.0.4515.131 (Official Build) (64-bit)

Follows 2 prints using Microsoft and 1 with Google. Each of them with the console log.

File not found

filenotfound.htm?llcc=pt-BR&hid=2aac64e7-0f2e-4b6a-a189-b1c96126a54b:1 [Deprecation] Synchronous XMLHttpRequest on the main thread is deprecated because of its detrimental effects to the end user's experience. For more help, check https://xhr.spec.whatwg.org/.
loadScript @ filenotfound.htm?llcc=pt-BR&hid=2aac64e7-0f2e-4b6a-a189-b1c96126a54b:1
/favicon.ico:1 Failed to load resource: the server responded with a status of 404 ()

An error has occurred

errorpage.htm?llcc=pt-BR&hid=ee2e7caf-470b-4d47-ad4e-2ce80ed4f592:1 [Deprecation] Synchronous XMLHttpRequest on the main thread is deprecated because of its detrimental effects to the end user's experience. For more help, check https://xhr.spec.whatwg.org/.
loadScript @ errorpage.htm?llcc=pt-BR&hid=ee2e7caf-470b-4d47-ad4e-2ce80ed4f592:1

No preview available

viewer:1 Unchecked runtime.lastError: Could not establish connection. Receiving end does not exist.
i:1 Failed to load resource: net::ERR_BLOCKED_BY_CLIENT