Skip to content
This repository has been archived by the owner on Sep 25, 2022. It is now read-only.
/ Viewhance Public archive

Enhancements for the browser's default media viewer

License

Notifications You must be signed in to change notification settings

Deathamns/Viewhance

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Viewhance

A browser extension to enhance the browser's default media viewer.

To try it out (when installed), open a media file (image / video / audio) in a new tab.

Install / Changelog / FAQ

Browser/platform support

The following platforms are supported (for each the latest browser version):

  • crx - mostly WebExtension (Firefox), and Chromium browsers (Chrome, Opera 15+, Vivaldi, Edge...)
  • xpi (legacy) - XUL based platforms (older Firefox, SeaMonkey, Pale Moon...)
  • oex (legacy) - Opera 12 (Presto based)
  • mxaddon (legacy) - Maxthon
  • safariextz (legacy) - Safari v5.1 - v12

Build

./build.py [platform(s)] [-meta] [-min] [-pack] [-all] [-version=x.x.x]

All arguments are optional. The output and temporary files go into the build directory.
Without arguments the script will generate the necessary files for each non-disabled platform.
Additional information for specific platforms can be found in their directories.

platf1 platf2... list of platforms (directory names under platform/) if building for all platforms is not desired
-meta generates only meta-data (localization, manifest files)
-pack creates installable/distributable packages (with -meta it will also generate meta files for updating)
-min compress source files (JS, HTML, CSS) (Java is required)
-all build disabled platforms as well (if it's not listed as a platform already)
-version=x.x.x custom version string, current date-time (YYYY.MMDD.HHII) if not set

Examples:

# Prepare directories for non-disabled platforms
./build.py

# Prepare directories for Firefox (XUL) and Opera (Presto)
./build.py xpi oex

# Prepare directories and package them for every platform (including disabled)
./build.py -pack -all

# Prepare, minify, and package for Chromium
./build.py crx -min -pack

# Generate meta-data for Maxthon and Safari
./build.py -meta mxaddon safariextz

Contribution

  • Localization You can use this helper tool for translating strings. The result can be sent as a pull request on GitHub (instructions are shown when you export your work on the localizer page).
  • Code If you have a bug-fix, or did some tweaks, then you can send a pull request with your changes. Criteria: Try to respect the code styling, use eslint, don't diverge too much from the main goal; viewing enhancements. The code must work on all supported platforms, except if the browser's extension API doesn't provide appropriate functionality, then fail silently.