Package 'rstudiothemes'

Convert a TextMate theme to Visual Studio Code or Positron

Description

Convert a .tmTheme file representing a TextMate theme and write the equivalent Visual Studio Code theme (.json).

convert_tm_to_positron_theme() is an alias of convert_tm_to_vs_theme().

Usage

convert_tm_to_vs_theme(
  path,
  outfile = tempfile(fileext = ".json"),
  name = NULL,
  author = NULL
)

convert_tm_to_positron_theme(
  path,
  outfile = tempfile(fileext = ".json"),
  name = NULL,
  author = NULL
)

Arguments

path	Path or URL to a TextMate theme, in .tmTheme format.
outfile	Path where the resulting file will be written. Defaults to a temporary file via tempfile().
name	Theme name. If NULL, uses the name from the input file.
author	Theme author. If NULL, it attempts to extract the author from the input file, otherwise defaults to "rstudiothemes R package".

Value

This function is called for its side effects. It writes a new .json file to outfile and returns the path.

See Also

Other functions for creating themes: convert_to_rstudio_theme(), convert_vs_to_tm_theme()

Examples

tmtheme <- system.file("ext/test.tmTheme",
  package = "rstudiothemes"
)
path <- convert_tm_to_vs_theme(tmtheme)

readLines(path) |>
  head(50) |>
  cat(sep = "\n")

---

Convert a TextMate, Visual Studio Code or Positron theme to RStudio

Description

Convert a .tmTheme or .json file that defines a TextMate or Visual Studio Code theme and write the equivalent RStudio theme (.rstheme).

Optionally, the generated theme can be installed and applied to the RStudio IDE.

Important: This function only works in RStudio. It returns NULL when called from other IDEs.

Usage

convert_to_rstudio_theme(
  path,
  outfile = tempfile(fileext = ".rstheme"),
  name = NULL,
  use_italics = TRUE,
  output_style = "expanded",
  force = FALSE,
  apply = FALSE
)

Arguments

path	Path or URL to a TextMate theme (.tmTheme format) or a Visual Studio Code theme (.json format).
outfile	Path where the resulting file will be written. Defaults to a temporary file via tempfile().
name	Theme name. If NULL, uses the name from the input file.
use_italics	Logical. Use italics in the resulting theme. The default is TRUE, although some themes may look better without italics.
output_style	Bracketing and formatting style of the CSS output. Possible styles: "nested", "expanded", "compact", and "compressed".
force	Whether to force the operation and overwrite an existing file with the same name. Default: FALSE.
apply	Logical. Apply the theme with rstudioapi::applyTheme().

Details

RStudio supports custom editor themes in two formats, .tmTheme and .rstheme. The .tmTheme format originated with TextMate and has become a common theme format. This tmTheme editor hosts a large collection of .tmTheme files. The .rstheme format is specific to RStudio.

To switch editor themes, go to ⁠Tools > Global Options > Appearance > Add⁠ and use the Editor theme selector.

For more information, see https://docs.posit.co/ide/user/ide/guide/ui/appearance.html.

Value

This function is called for its side effects. It writes a new .rstheme file to outfile and returns the path. If force or apply is TRUE, it installs the theme and applies it to your RStudio IDE.

See Also

rstudioapi::addTheme(), rstudioapi::applyTheme()

Other functions for creating themes: convert_tm_to_vs_theme(), convert_vs_to_tm_theme()

Examples

if (on_rstudio() && interactive()) {
  vstheme <- system.file("ext/skeletor-syntax-color-theme.json",
    package = "rstudiothemes"
  )

  # Apply the theme for 10 seconds to demonstrate the effect.
  current_theme <- rstudioapi::getThemeInfo()$editor

  # Current theme name.
  current_theme
  new_rs_theme <- convert_to_rstudio_theme(vstheme,
    name = "A testing theme",
    apply = TRUE, force = TRUE
  )

  Sys.sleep(10)

  rstudioapi::applyTheme(current_theme)
  rstudioapi::removeTheme("A testing theme")
}

---

Convert a Visual Studio Code or Positron theme to TextMate

Description

Convert a .json file representing a Visual Studio Code or Positron theme and write the equivalent TextMate theme (.tmTheme).

convert_positron_to_tm_theme() is an alias of convert_vs_to_tm_theme().

Usage

convert_vs_to_tm_theme(
  path,
  outfile = tempfile(fileext = ".tmTheme"),
  name = NULL,
  author = NULL
)

convert_positron_to_tm_theme(
  path,
  outfile = tempfile(fileext = ".tmTheme"),
  name = NULL,
  author = NULL
)

Arguments

path	Path or URL to a Visual Studio Code or Positron theme, in .json format.
outfile	Path where the resulting file will be written. Defaults to a temporary file via tempfile().
name	Theme name. If NULL, uses the name from the input file.
author	Theme author. If NULL, it attempts to extract the author from the input file, otherwise defaults to "rstudiothemes R package".

Value

This function is called for its side effects. It writes a .tmTheme file to outfile and returns the file path.

See Also

Other functions for creating themes: convert_tm_to_vs_theme(), convert_to_rstudio_theme()

Examples

vstheme <- system.file("ext/test-simple-color-theme.json",
  package = "rstudiothemes"
)
path <- convert_vs_to_tm_theme(vstheme)

readLines(path) |>
  head(50) |>
  cat(sep = "\n")

---

Generate random UUIDs

Description

Generate version 4 (pseudo-random) Universally Unique Identifiers (UUIDs).

Usage

generate_uuid(hint = NULL)

Arguments

hint	Optional character string, or object coercible with as.character(), to use as a random seed.

Details

This helper generates a UUID for identifying generated theme versions.

Value

A character string representing a valid UUID that can be validated with uuid::UUIDvalidate().

Source

Heavily based on an unreleased version of ids::uuid().

References

Davis KR, Peabody B, Leach P (2024). "Universally Unique IDentifiers (UUIDs)." RFC 9562. doi:10.17487/RFC9562, https://www.rfc-editor.org/info/rfc9562.

See Also

Other helpers: on_rstudio()

Examples

# Random UUID.
generate_uuid()

generate_uuid()

# Persistent UUID with `hint`.
hint <- "something as seed"

generate_uuid(hint)

generate_uuid(hint)

---

Check whether the session is running in RStudio

Description

Detect whether the current R session is running in RStudio, which is used to decide whether themes can be applied to the IDE.

Usage

on_rstudio()

Value

TRUE if running in RStudio, FALSE otherwise.

See Also

Other helpers: generate_uuid()

Examples

on_rstudio()

---

Read and parse a TextMate theme

Description

Read a .tmTheme XML file representing a TextMate or Sublime Text theme.

Usage

read_tm_theme(path)

Arguments

path	Path or URL to a TextMate theme, in .tmTheme format.

Value

A tibble with the theme data.

See Also

Other functions for reading themes: read_vs_theme()

Examples

the_theme <- system.file("ext/test-color-theme.json",
  package = "rstudiothemes"
) |>
  # Convert the Visual Studio Code theme to TextMate format.
  convert_vs_to_tm_theme()

# Check the converted theme.
readLines(the_theme) |>
  head(10) |>
  cat(sep = "\n")

read_tm_theme(the_theme)

---

Read and parse a Visual Studio Code or Positron theme

Description

Read a .json file representing a Visual Studio Code or Positron theme.

read_positron_theme() is an alias of read_vs_theme().

Usage

read_vs_theme(path)

read_positron_theme(path)

Arguments

path	Path or URL to a Visual Studio Code or Positron theme, in .json format.

Value

A tibble with the theme data.

See Also

Other functions for reading themes: read_tm_theme()

Examples

vstheme <- system.file("ext/test-color-theme.json",
  package = "rstudiothemes"
)
read_vs_theme(vstheme)

---

Install, list, preview or remove RStudio themes

Description

Adapted from selected rsthemes functions. MIT License Copyright © rsthemes authors.

Important: These functions only work in RStudio and return NULL when called from other IDEs. The exception is list_rstudiothemes(list_installed = FALSE).

Usage

install_rstudiothemes(
  style = c("all", "dark", "light"),
  themes = NULL,
  destdir = NULL
)

remove_rstudiothemes(style = c("all", "dark", "light"))

list_rstudiothemes(style = c("all", "dark", "light"), list_installed = TRUE)

try_rstudiothemes(style = c("all", "dark", "light"), themes = NULL, delay = 0)

Arguments

style	Theme group: "all", "dark", or "light".
themes	Optional character vector of theme names. If provided, only these themes are used and style is ignored.
destdir	Optional directory for .rstheme files. By default, it uses rstudioapi::addTheme(), but this argument allows installation to non-standard directories.
list_installed	Should the installed rstudiothemes themes be listed (default). If FALSE, the available themes in the rstudiothemes package are listed instead.
delay	Number of seconds to wait between themes. Set to 0 to be prompted to continue after each theme.

Value

install_rstudiothemes() and remove_rstudiothemes() return NULL invisibly.

list_rstudiothemes() returns a character vector of theme names.

try_rstudiothemes() has side effects: it starts a widget that allows users to try different themes. The widget can be exited by following the prompts, which restore the original theme.

Functions

• install_rstudiothemes(): Install RStudio themes.

• remove_rstudiothemes(): Remove rstudiothemes themes from RStudio.

• list_rstudiothemes(): List installed or available themes.

• try_rstudiothemes(): Preview each rstudiothemes RStudio theme.

Ported themes

rstudiothemes includes RStudio themes based on the following Visual Studio Code themes:

• Ayu by teabyii.

• Andromeda Theme by Eliver Lara.

• Catppuccin Theme by Catppuccin.

• Cobalt2 Theme by Wes Bos.

• CRAN Theme by dieghernan, based on the CRAN (R Project) website theme, created with Pandoc.

• Dracula Theme by Dracula.

• GitHub Dark and Light Themes by GitHub.

• JellyFish Theme by Pawel Borkar.

• Matcha Theme by Luca Falasco.

• Matrix Theme by UstymUkhman.

• Night Owl Dark and Light Themes (no italics) by Sarah Drasner.

• Nord Theme by Arctic Ice Studio.

• OKSolar Theme by dieghernan.

• One Dark Pro Theme by binaryify.

• Overflow Theme by dieghernan.

• Panda Theme by Panda Theme.

• Selenized Themes by dieghernan.

• Skeletor Syntax Theme by dieghernan.

• SynthWave '84 Theme by Robb Owen.

• Tokyo Night Theme by Enkia.

• Winter is Coming Theme by John Papa.

Author(s)

Garrick Aden-Buie https://github.com/gadenbuie

References

Aden-Buie G (2026). rsthemes: Full Themes for RStudio v1.2+. R package version 0.5.1, commit 48fc078f772e5e63669bc9773eabc8e9cdc7f699, https://github.com/gadenbuie/rsthemes.

Examples

list_rstudiothemes(list_installed = FALSE)

---