Native application

Intro

This is a little application. We develope it to enhance MaoXian’s abilities.

Important News

On the latest version of ruby which is 2.7.0, there’s some interfaces are not compatible with old code. It’ll cause this Native APP not able to download images. So if you have installed ruby 2.7.0 and your Native App’s version is less than 0.2.3, you should upgrade it.

Features

• Download file (to avoid conflic with download manage extention)
• Delete clipping file (when you delete a clipping record in clipping history page, it delete files that relative to that record)
• Refresh history (This is useful when you have two clipping sources(e.g. two browsers on same computer or different computers) and want to keep clipping history latest)

Installation

Install ruby

ruby is required, install it first. Make sure version >= 2.4.1.

Install Ruby

Download

Download software according to your OS and browser type.

Current Version 0.2.12

• Linux
  • native-app-chrome.zip
  • native-app-chromium.zip
  • native-app-firefox.zip
• Mac
  • native-app-chrome.zip
  • native-app-chromium.zip
  • native-app-firefox.zip
• windows
  • native-app-chrome.zip
  • native-app-chromium.zip
  • native-app-firefox.zip

Extract zip file

in linux or mac

unzip maoxian-web-clipper-native-linux-chrome.zip -d maoxian-web-clipper-native

in windows

Use any extract software your like, extract it to a fold :D

install the software

• Mac or Linux: ./install.sh
• Windows: double click install.bat

configure download path

You must configure your download path first,

You will find a file named config.yaml, use any text editor to edit it. Notice: if you OS is windows, don’t edit it use notePad, use something like notepad++ which can handle line break correctly.

Notice: download path must exist

e.g in linux

# config.yaml
environment: 'production'
data_dir: '/home/jack/clippings'

e.g in windows

# config.yaml
environment: 'production'
data_dir: 'e:\jack\clippings'

configure MaoXian Web Clipper

• Allow extension to access File URLs. (See: extension setting page > File URL)

• choose Download through native App as clipping handler. (See: extension setting page > Clipping Handler)

• reboot your browser

Finish. :D

uninstall

• Mac or Linux: run ./uninstall.sh and delete Native App directory.
• Windows: double click uninstall.bat and delete Native App directory.

upgrade

1. Backup config.yaml
2. Uninstall Native App
3. Download latest version in current page and extract it.
4. Replace config.yaml in extracted directory using the file we had backuped in first step.
5. Install this Native App

---

Home