Skip to content

Create calender wallpapers for your desktop and phone from R.

Notifications You must be signed in to change notification settings

JBGruber/wallpapr

Repository files navigation

wallpapr

Codecov test coverage R-CMD-check

wallpapr is a little toy R package to make desktop and phone backgrounds. The design is inspired (aka copied one-to-one) by the beautiful calender wallpapers of Emma. You can check out her wallpapers at: emmastudies.com/tagged/download. With this package you can create your own calender wallpapers using an input image.

Installation

You can install wallpapr from GitHub with:

# install.packages("remotes")
remotes::install_github("JBGruber/wallpapr")

Examples

The package comes with two pictures you can use: a monochrome background in Zima blue and a snapshot from the Isle of Mull I took:

library("wallpapr")
make_wallpapr(
  system.file("extdata", "zima.png", package = "wallpapr"),
)

By default, the wallpaper will have the same resolution and output format as the input image and the calendar is displayed in the center of the image. You can move the calendar using the position argument.

library("wallpapr")
make_wallpapr(
  system.file("extdata", "zima.png", package = "wallpapr"),
  position = "topright"
)

If you use an image of a different size than 1920x1080, you might have to fiddle around with the text_size and headline_factor options. Additionally, you can use a different font:

make_wallpapr(
  system.file("extdata", "zima_4k.png", package = "wallpapr"),
  family = "Purisa",
  text_size = 16,
  headline_factor = 2
)

Of course, the main thing you want to do is to use a stunning background image for your calendar wallpaper:

library("wallpapr")
make_wallpapr(
  system.file("extdata", "mull.jpg", package = "wallpapr"),
  family = "Purisa"
)

By default, the current month is used to produce the wallpaper. If you want to plan ahead and get a calendar for a different month, enter either a date or the name of a month (produces the month of the current year).

library("wallpapr")
make_wallpapr(
  system.file("extdata", "mull.jpg", package = "wallpapr"),
  filename = "August.jpg",
  month = "August",
  family = "Purisa",
  start_monday = FALSE # change when the week starts for you
)

It is also possible to use a wallpaper size different from the input image. Make sure though that the input image is large enough (otherwise the additional space is filled with the fill colour):

make_wallpapr(
  system.file("extdata", "zima_4k.png", package = "wallpapr"),
  resolution = c(1080, 1920), # first number is width, second height
  family = "Purisa",
  fill = "grey"
)

When this happens, you can employ the scale argument to scale and crop the image into a format which fills the entire "width" or "height" of the calendar.

make_wallpapr(
  system.file("extdata", "zima_4k.png", package = "wallpapr"),
  resolution = c(1080, 1920), # first number is width, second height
  family = "Purisa",
  fill = "grey",
  scale = "height"
)

If you have a picture in a wrong size or without background colour, you can also use fill to fill the remaining space:

make_wallpapr(
  "https://www.r-project.org/logo/Rlogo.png",
  resolution = c(1080, 1920),
  colour = "black",
  fill = "darkseagreen",
  family = "Purisa"
)

About

Create calender wallpapers for your desktop and phone from R.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages