MyNixOS website logo
Description

Creates an Executable Shortcut for Shiny Applications.

Provides function shinyShortcut() that, when given the base directory of a shiny application, will produce an executable file that runs the shiny app directly in the user's default browser. Tested on both windows and unix machines. Inspired by and borrowing from <http://www.mango-solutions.com/wp/2017/03/shiny-based-tablet-or-desktop-app/>.

shinyShortcut

Travis Build Status AppVeyor Build Status codecov

Overview

This package allows users to create a shortcut for their shiny app that, when run, will launch the app directly in the user's default browser. No need to navigate to the correct working directory in R (or even to open R at all!). Simply run the shortcut and the app will fire up. Works for both windows and linux based systems.

Inspired by this blog post by Mark Sellors at Mango Solutions.

Installation

# Package not yet on CRAN, needs installed from Github:
# install.packages("devtools")
devtools::install_github("ewan-keith/shinyShortcut")

Usage

The package loads just a single function, also named shinyShortcut(). It takes three arguments:

  • shinyDirectory: The home directory of your shiny app (that contains your server.r, ui.r, or app.r files).
  • OS: The operating system for the app to be ran on, must be "windows" or "unix".
  • gitIgnore: Whether to update the .gitignore file to prevent the shortcut files being tracked by git.

The function writes an exectuable script (.vbs on windows and .desktop on unix) in to the app's home directory. Shortcuts to this file can then be created elsewhere on the user's system. The function also creates a new directory /.shiny_run into which is written the raw batch or bash script (Windows and unix respectively) that runs the shiny app.

When the shinyDirectory is the current working directory then the default arguments are sufficient.

library(shinyShortcut)

shinyShortcut()
Metadata

Version

0.1.0

License

Unknown

Platforms (77)

    Darwin
    FreeBSD
    Genode
    GHCJS
    Linux
    MMIXware
    NetBSD
    none
    OpenBSD
    Redox
    Solaris
    WASI
    Windows
Show all
  • aarch64-darwin
  • aarch64-freebsd
  • aarch64-genode
  • aarch64-linux
  • aarch64-netbsd
  • aarch64-none
  • aarch64-windows
  • aarch64_be-none
  • arm-none
  • armv5tel-linux
  • armv6l-linux
  • armv6l-netbsd
  • armv6l-none
  • armv7a-darwin
  • armv7a-linux
  • armv7a-netbsd
  • armv7l-linux
  • armv7l-netbsd
  • avr-none
  • i686-cygwin
  • i686-darwin
  • i686-freebsd
  • i686-genode
  • i686-linux
  • i686-netbsd
  • i686-none
  • i686-openbsd
  • i686-windows
  • javascript-ghcjs
  • loongarch64-linux
  • m68k-linux
  • m68k-netbsd
  • m68k-none
  • microblaze-linux
  • microblaze-none
  • microblazeel-linux
  • microblazeel-none
  • mips-linux
  • mips-none
  • mips64-linux
  • mips64-none
  • mips64el-linux
  • mipsel-linux
  • mipsel-netbsd
  • mmix-mmixware
  • msp430-none
  • or1k-none
  • powerpc-netbsd
  • powerpc-none
  • powerpc64-linux
  • powerpc64le-linux
  • powerpcle-none
  • riscv32-linux
  • riscv32-netbsd
  • riscv32-none
  • riscv64-linux
  • riscv64-netbsd
  • riscv64-none
  • rx-none
  • s390-linux
  • s390-none
  • s390x-linux
  • s390x-none
  • vc4-none
  • wasm32-wasi
  • wasm64-wasi
  • x86_64-cygwin
  • x86_64-darwin
  • x86_64-freebsd
  • x86_64-genode
  • x86_64-linux
  • x86_64-netbsd
  • x86_64-none
  • x86_64-openbsd
  • x86_64-redox
  • x86_64-solaris
  • x86_64-windows