How to Make Template Files for Your reMarkable

I previously posted about how you can access your reMarkable through the terminal on your Mac along with changing out it’s default sleep screen image. Now I want to share how I’ve taken a PDF, or a PNG image file, and converted it into a template that I can use with my reMarkable2.

Image is geared towards Pinterest and shows four images, my blog title, and my main URL. Above the title you can see a screenshot of GIMP with an open PNG in Preview. Below is a collage of three images showing my reMarkable2 with the newly uploaded template, words written on the template, and the JSON file showing the newly entered template. All images are also found below.

For future reference I’m writing this while using my reMarkable2 running version of the software.

The templates for the reMarkable needs to be in a PNG format. This means if you want to use a PDF as a template you need to first convert each individual page into a PNG image file and then use each of those images as a stand alone template. This also means you can create your own templates by creating an image file. Just remember that the screen is 1872 by 1404 pixels so you’ll want to keep your template the same dimension. Also, if you’re planning on using this template with the writing tools open, for the tool selection, you may want to leave a blank space on the left hand side so it doesn’t hide anything when it’s open. Once you’ve created your image file, uploaded it to your reMarkable, and edited the JSON file you’ll be able to use your custom image in any notebook page you want.

I’m going to start out by going over the reMarkable’s notebooks, pages, and layers in case you don’t know what their template is and how it’s used. I’ll then go over how I access the reMarkable template directory (also called folder) quickly by adding a symbolic link to my home directory and then follow that up by explaining the two methods I used to create a template image (via a PDF or GIMP). I’ll then share how I uploaded my image to my reMarkable2 and then finally how I edited the JSON file so the reMarkable is capable of seeing the new template file.

Also one quick warning. I haven’t had my reMarkable2 long enough to bring it through a software update, but I’ve heard that when it updates templates you’ve uploaded in the past may be removed. Again, I haven’t had it happen to myself but just in case I’m planning on keeping the PNG images I uploaded also on my computer and will, going forward, keep track of any JSON updates so I can easily fix anything after an update.

Quick Overview on the reMarkable: Notebooks, Pages, PDFs, Templates, and Layers

The reMarkable device lets you create numerous notebooks with many pages within. For each page you can check out the layers, by going through the writing tools menu that pops up on the left side of the screen, and change out what the background template is. By default, when created, each page will have two layers that consist of the template, bottom layer, and a blank layer over top allowing you to write over the template. If you want to switch out the template all you need to do is click on that layer and, once the options open, choose which template you want that page to show instead. Then when you swipe to create a new page it will, by default, have that last chosen template as it’s own template. This means you can have a notebook with each page having the same template or change out each page making them all different. An example of this might be a journal where the pages can include a monthly calendar, a weekly calendar, a grid to design on, or blank pages to draw on. This also means you can switch out a page halfway through a drawing, say if you wanted to start out with a grid to help draw something, and then switch out the template to something else; say perspective lines to help draw the background around the object. These templates can also be used in other notebooks which means, if you want, you could use the same template in each notebook you create.

Image shows my reMarkable2 with the words "Today is the Day" scrawled out in three different pen types. Behind it are lines reaching out to the center back of the page.
I was creating a quick sample for you so I quickly scrawled my text over the template with the perspective grid lines in the background.
Image shows the reMarkable2 with the pen set aside. On it you can see many of the templates listed with image snapshots above them. The "weeklyplanner 2" is selected.
If you want to change your template you can easily open the layers option and click on your current template to open up a grid showing all the possible templates. In this case I next chose one of the weekly planner views.
Image shows the text "Today is the day" over top of the blank weekly calendar view template. The menu is open on the left and the popup menu, from the bottom layers option, is opened and overlapping with the page. On it you can see the selected "Layer 1", "Template", and "Add layer" options.
As you can see the text I wrote, confined to Layer 1 is still visible although the template behind it changed to the calendar view.
Image shows the text over a blank page with the menu popup still open and overlapping with the bottom of the letters. The pen is laid over top of the reMarkable2.
There is a blank template but since the template is confined via layers you can also make the current invisible quite easily too.

In addition to the notepads with the pages and templates the reMarkable also allows you to upload a PDF. This PDF can kind of feel similar to a template as you can still add layers over top of each page and mark it up however you’d like. Templates are not the same as PDFs; however, as you cannot add or remove pages, since it’s static, or change the background as it isn’t editable. You also can’t use any of the pages in a notebook and the only way you’d have more than one copy is if you duplicate the entire PDF.

Image shows the January 2021 calendar with the first three weeks partially erased with my black text written over top. My pen is posed over the 22nd as I 'erase' the title of the planned workout so I can write what I did instead.
I’ve started putting my single page PDF for my Balanced Life Pilates Sisterhood membership on my reMarkable2 so I can keep track of my daily workouts. As I can’t edit the PDF itself I’ve switched to a pen option that allows me to choose my ink color, in grayscale, so I can use white ink to essentially erase the text when I want more room to write what I did.

Simplify the Process With a Symbolic Link

When I was first starting to look into how I could create my own templates I came across the reMarkableWiki’s article on Customizing the Templates that was perfect for telling me what to do. In it I discovered that the templates are stored nested within several directories so rather than memorizing the pathway, which I kind of still did, I chose to create a symbolic link in the reMarkable2’s home directory so I could get there more easily. In case you’re curious the pathway is: /usr/share/remarkable/templates/.

To create the symbolic link I called on the link command, ln, and specified that I wanted it to be a symbolic link using the -s parameter. I then followed the parameter with the target pathway, where you want the link to target, and then followed that with the name I wanted to use for that link. So in this case I’d go to my reMarkable2’s home directory and create a symbolic link to the nested directory and label it templates by typing in:

ln -s /usr/share/remarkable/templates templates

This means I now have, what feels like, a directory named templates located in my home directory. When I cd, change directory, into it I’m actually now in /usr/share/remarkable/templates.

Image shows a screenshot of my reMarkable2's command interface on my iTerm. When I wrote ls I get back the names of the files and directories in my home directory. When I typed in ls -l I got more information about each one: 
-rw-r--r--    1 root   root  107430 Jan 10 21:36 log.txt
lrwxrwxrwx  1 root   root         31 Jan 10 21:44 templates -> /usr/share/remarkable/templates
You can confirm the templates directory was created properly by running an ls, list directory, command using the long listing parameter, -l, on your home directory as it will show you what the templates directory you made points to. You can see the difference in the results if you do a common ls command rather than the fuller ls -l command.

Creating Your Template Image

Templates for the reMarkable needs to be in PNG format, but there are so many different ways you can use to create the PNG file. If you look online you can find some free PDFs and PNGs, like in the How to get the best of my reMarkable? group on Facebook, or many templates sold on Etsy. I haven’t tried any of those yet but I have created my own PNG image from a PDF that I already had along with using the free GNU Image Manipulation Program (GIMP) to create a single image by combining two smaller ones together. I figured I’d share both of these ways with you. If you are looking for a different way to create an image you can check out rM User’s Customize Your reMarkable Screens as it touches on making the sleep screen image using several different image editors.

From a PDF

With your reMarkable it’s really simple to convert your PDF into a single or multiple PNG image files. First I added my PDF to my reMarkable2 through the app on my Mac computer; although, if you don’t want to install their app you could always transfer the files using a USB cable instead. Once the PDF is synced to your reMarkable you can simply tap on it to open and then, through the bottom of the left side menu, email the PDF to yourself as one or multiple PNG files. And with that you now have a PNG file for each page in the PDF that you chose to send to yourself.

Image shows the bottom half of a partially blank PDF page. The menu on the left is open with the 'Share' image select. There's a two item menu opened beside it showing "LiveView (Beta)" and "Send by email".
Once I uploaded the PDF to my reMarkable2 I was able to open it up and choose to sent it back to myself via email.
Image shows the bottom half of the reMarkable when it's showing the options when emailing a PDF to you.
After selecting Send by email this view pops up. At the top I pick, or enter, my email address, skip over the message and filename, and go to the bottom where I select PNG for my Export format and then tap on Edit since I want to email more than one of the pages to me. By default this is set to the single page you were on when you chose to email it out.
Image shows a list of all the pages in my PDF which allows me to select the ones I want to email myself.
Once tapping Edit on the lower left side you’re shown all the pages in your PDF. Here you select all the pages that you want sent to your provided email account as a PNG file.

From Scratch

You could also create an image to use as a template yourself. I’ve previously used both my reMarkable2 and the website Canva to create two different sleep screen images for when I suspend my device. Just remember any image you use needs to be in a PNG format so it can be seen as a template.

A couple of weeks ago I was making my girls pancakes from a recipe, taken from Healthy One Pan Dinners I reviewed a bit ago, that I’ve been making minor changes to over time as I ran out of ingredients or simplified the process. I realized if I ever take a long break from making this I might just forget what I’ve changed. This lead me to realize that I should maybe make a cookbook-related notebook on my reMarkable but as I wanted to add to it over time I needed it to be a notebook rather than figure out how to create a PDF. I realized I should make my recipe a template, even though I only want it to exist on a single page in a single notebook, so I opened up the free GIMP I had installed, set the blank canvas to the proper size (1872 by 1404 pixels), and copied the two screenshot images I used for my recipe onto the canvas. After rearranging the layers they were on and liking my final layout I exported the newly created image as a PNG so I could use it on my reMarkable2. It was really simple and quick to make.

Image shows the screenshot from the cookbook opened on my computer in the Photo app. The Edit menu is opened with the Copy row highlighted.
I had the recipe saved in my Photos app so I went and found it and copied the image using the Copy option in the Edit menu.
Image shows GIMP opened and me going through the "Edit" menu to "Paste as" to get to "New Layer".
I then went into the blank canvas I had just made in GIMP and pasted the image as a new layer so I could easily move it around. To paste it as a new layer I went into the Edit menu, selected Paste as, and then chose New Layer.
Image shows the white GIMP canvas with words on it. The rightmost image has a dashed line surrounding it to show the size of the layer.
After copy and pasting both images, each as a new layer, onto my GIMP canvas I was able to rearrange them to my liking.
Image shows GIMP opened in the background, to the left, with the newly exported image open to the right.
Once I liked how the canvas looked I exported the image as a PNG so I could go on to upload it to my reMarkable2.

As an aside if you’re making an image for your template don’t create it with a transparent background. I’ve only made mine with white backgrounds so I haven’t tested anything although I’ve heard it can cause weird issues when you erase over such a transparent template.

Upload the Template Image

Once you have your PNG image chosen it’s time to upload the image onto your reMarkable. Since the files you upload to the reMarkable, through their app, goes in a different location I needed to connect through my terminal instead. To connect you’ll first need to go into your settings to find your username, password, and IP address which I shared how to do in my first reMarkable post. In addition to that I also included how to use your computer’s public key instead of your password and how to create a shortcut in your ssh config file to skip typing in the username and IP address each time you connect.

I wanted to keep this newly created template image separate from all of the default ones already on my device so once I connected to my reMarkable and navigated to the templates directory the first thing I did was create a new directory I titled Recipes. I love how it seems that you can create any directory structure, within the templates directory, to organize your template images. The commands I used to do this were:

cd /usr/share/remarkable/templates
mkdir Recipes

I next opened up another terminal window, on my computer, and made sure the working directory was set to the same one where my new template image was saved. This means, when uploading the file, I only need to type in the name of my image file rather than the whole pathway leading up to my image. To upload the image I used the scp command which securely copies files between two hosts on a network. Specifically, I typed in:

scp imageName.png root@XXX.XXX.XXX.XXX:/usr/share/remarkable/templates/Recipes/


  • scp is the program I used which you can read more about through Duke University’s SCP Unix man page.
  • imageName.png is the file I was to transfer. This can also be written with the relative or absolute pathway before the image name if you aren’t located in the same directory as your image. GeeksforGeeks wrote Absolute and Relative Pathnames in UNIX if you’re interested in learning more about them.
  • root@XXX.XXX.XXX.XXX is the username and IP address listed on your reMarkable under Copyright and licenses. It’s format is the same as an email address where you put your name at (@) email service.
  • : is used to separate the previous username and IP address from the pathway that follows.
  • /usr/share/remarkable/templates/Recipes/ is the pathway, on your reMarkable, where you want your template image to go. All of the other template images go into the templates directory but I had made a Recipes directory inside of it to keep any recipe-related templates I may make in the future separate. NOTE: If you set up a symbolic link, as shown above, you can use that here too.

The image uploaded really fast so there wasn’t a lot of time to be able to marvel at the progress indicators that the terminal showed before it reached 100% and finished. Once the image was uploaded I connected to my reMarkable2 and navigated to the proper directory (/usr/share/remarkable/templates/Recipes/) and used the ls command to list the directory’s contents and confirm that my image was actually there.

Image is a screenshot of my terminal after I uploaded the HealthyOnePanDinners_Pancakes.png image file.
I used the scp command to upload my PNG to the proper directory on my reMarkable2.
Image is a screenshot of my terminal located in the directory containing my image. The image shows the ls command and resulting output.
To confirm that the image file properly uploaded I used ssh to connect to my reMarkable device, navigated to my newly created Recipes directory, and used the ls command to confirm the image was truly there.

Edit the JSON file

Uploading the PNG image to the proper directory doesn’t make the reMarkable suddenly see the new template. To be able to use this image as a template you need to first enter it in the templates’ JSON file located in with the other template images and called templates.json. To see an example of this and learn more about Customizing the Templates you can check out reMarkableWiki’s post.

As I’m interacting with my reMarkable2 through my terminal window I’m confined to staying within the command line interface so to edit the templates.json file I chose to use vim; although, you could use whatever text editor you prefer here. The biggest thing to know about this JSON file is that you don’t want to mismatch any of the brackets and you should pay attention to the indentation of each line as further indents means a different sub-item. The templates.json file just lists each and every template that the reMarkable has so once I opened the file I immediately scrolled down to the bottom, copied the example in the reMarkableWiki’s post, pasted it underneath the last listed template item, and edited the text to fit my image’s information. When pasting it in I made sure to select the spot between the previous entry’s closing curly bracket yet still stay above the square brackets closing the JSON file. As each of these curly bracket enclosed entries are separated by a comma I also made sure to add another comma between my entry and the previous one. I added:

  "name": "One Pan Dinner - Pancakes",
  "filename": "Recipes/HealthyOnePanDinners_Pancakes",
  "iconCode": "\ue98c",
  "categories": [

where the lines mean:

  1. The comma separating this entry from the previous one.
  2. The opening curly bracket to show my entry is starting.
  3. This is where you specify the name you want the template to be called. In my case I wanted to be able to identify this template among many, potentially, other recipe templates so I started out defining it with a variation of the cookbook’s name, titled Healthy One Pan Dinners, and then added on what the recipe was for. Technically, the real recipe name is longer but I wanted to keep my template name as short and to the point as I could.
  4. This is the filename of your template PNG image without the extension included. If I had added my image in with all of the other templates then this would only be my filename, HealthyOnePanDinners_Pancakes, but as I put my image in a sub-directory, Recipes, I needed to include that as my path to my filename so my reMarkable2 could find it.
  5. This is the image that will be shown when browsing through all of the templates. The Customizing the Templates post lists all of the possible images you can set this to and I chose the largest hexagon one.
  6. The categories value uses a list to set the specific category your template is categorized under which makes me wonder if you could have a multi-item list here that would place a single template under multiple categories. Anyway, here we’re opening the list by using a square bracket before…
  7. … setting the category name we want our template to be organized under. In my case I decided to create a new category named Recipes although you could check out the other templates.json entries to see what the predefined categories are if you want your template to be added to one of those. With the category defined….
  8. … we now close the categories list using the opposing square bracket.
  9. Finally we close the entry we created using the other facing curly bracket. This means our entry is now fully caught within the curly brackets. If you wanted to add a second template image you’d follow this with a comma, to separate the entries, and then continue up at number 2.

The items in the entry are indented to show the section you’re in. This means we use two spaces within the curly brackets, so lines three to eight, to show we’re in the entry. Then we use another two spaces to further indent the categories list. Some programming languages, and personal formatting, uses tabs to indent while others use a pre-defined number of spaces… in this case two. Essentially every time you create a subsection it’s indented and every time you leave a subsection you stop indenting it to that degree. You can learn more about JSON on your own through the tutorials or through Omar Elgabry’s Medium article JSON In a Nutshell.

Additionally, within the information about your template image you can also include whether the image is in landscape or portrait mode by whether the parameter landscape is set to true or false. As my image was in portrait mode, a value of false, which is the default value I left it off so if you feel differently and/or your image is a landscape one you’ll want to include that line. Again more information can be found in the Customizing the Templates reMarkableWiki post.

Image shows a screenshot of the templates.json file opened through my terminal using vim. There are the last twenty of 695 lines showing. The bottom displays the file's pathway and name and below that my cursor sits at the end of ":wq" before pressing enter.
Screenshot of my terminal showing the bottom of the templates.json file after I added my newly created image file to the JSON. If you’re also in vim you can enter edit mode by typing i, specifically for insert mode, and once done use esc to escape insert mode. Then type :wq, seen at the bottom of the image, and Enter to save (w) and quit (q) the file. It saves and you’re back at the previous spot you were in before opening the file.

Does It Work?

And with that the new template image file is uploaded and should work on your reMarkable device. If you follow the reMarkableWiki post it says that after modifying the templates.json file you’ll “need to restart xochitl for it to be reloaded: systemctl restart xochitl“. I, however, ignored that bit and may have instead restarted my device, by going through settings, and forcing it to re-sync that way. Looking back I’m not 100% sure which I did the first time although I plan to re-sync it, in the future, by restarting xochitl.

Once your reMarkable connects to your new template file you’ll be able to see it when switching out the template on one of your notebook pages.

Image shows my reMarkable open on the table with the folio folded back and the pen resting on top of it. The reMarkable is on and showing the contents of the newly created Recipes category as I switch out the template for a notebook page.
I went into a random notebook and attempted to switch out the template on a page. After re-syncing the new category Recipes shows up at the end of the list of category headers and my new template shows up when I click on it. I chose the icon that displays hexagons and the title, One Pan Dinner - Pancakes, shows me it worked before I even needed to open it.
Image shows a closeup view of the reMarkable showing the logo on the pen, laid over top of the device, and the text I wrote over the template.
After creating a new notebook I quickly set my new template to the second page in it, after a cover page, and jotted down the changes I’d made to the recipe over the last couple months.

If Using reMarkable Apps on Other Devices

A couple weeks after making this template I went to make pancakes for the girls and figured I’d open the document through the reMarkable app on my mobile phone. I was met with a document that showed the text I had added but the background, with the recipe, was just an error message saying it was unable to load. I figured it was because I used a custom template and, after asking in the Facebook group How to get the best of my reMarkable?, that was confirmed. Just something to keep in mind if you use the desktop or mobile applications a lot. Going forward, since I’m not planning on adding recipes very often, I’m planning on exporting the notebook as a PDF, re-uploading it, and then I’ll have a copy accessible from all my devices.

The top of the image says "Recipes". Below it is a rectangle, cut off, showing the document page. In the center, lower in the image, it says "Unable to load document background[. ]Try restarting your application or contact support if the problem persists." To the side you can see the changes I made, in a different layer, over top.
This was the second page of my Recipes notebook while on my phone. The text I had added to the layer showed up but the custom template didn’t.

This was the first template I created and uploaded to my reMarkable2 and it was a rather specific one as I’m not planning on using it in more than the one spot. I decided to create the Recipes directory and category because then it’s really simple if I ever want to stop using the recipe notebook idea. If that ever happens I can easily convert the notebook to a PDF, by emailing it to myself, and then remove my recipe-related changes from the device. I can easily delete the entire Recipes directory, with the rmdir command, and then delete all of the additions I made to the JSON by searching for the category Recipes and manually removing the matching entries.

I could see this idea, with the easy addition and removal, working for any year, or month, specific templates you may only want to use. For instance any 2021-specific templates could be added to a new directory within the templates one along with the JSON category being labelled 2021 which makes it easier to find and remove. This could work perfectly for any calendars, like my Pilates monthly workout calendar, that you may want to combine in a single notebook instead of having over many different PDFs. Then at the end of the year you could easily export each notebook you used with those templates, so you could have them as they are in a PDF format, and then remove all the 2021-specific templates from the templates directory and related JSON file.

In the future I plan to make a script that takes multiple directories and contained PNG image files and easily curate them into the text needed to update the JSON file. Even though the files would still need to be uploaded and the JSON file edited manually this could still help towards batch adding template files quicker.

Update: I’ve now written that script, uploaded it to GitHub, added it to the readme, and wrote two posts (part one and part two) that go over it if you’re interested in speeding up your process.

Update 2: I’ve since come out with a video that combines several posts together including connecting via SSH, uploading the templates manually, and my bash script. You can find it here.

Update 3: I conducted an experiment to see which file type (PNG or SVG) would be used when exporting a notebook page from the reMarkable. Here are the results if you’re also interested!

Have you uploaded a template to your reMarkable device yet? If so how did it go? If not are you going to? Let me know if you have any questions by dropping them in the comments below. I hope your day is going truly great.

If you’re interested in getting any of my future blog updates I currently come out with a new one every Wednesday and share them to my Facebook page and Instagram account. You’re also more than welcome to join my email list located right under the search bar or underneath this post.


My name is Kyra and I’m a computer programmer that decided to stay at home with my two beautiful daughters: Ada and Zoey. I created this website to share with you anything I come across in my day to day life that I think you may enjoy.

You may also like...

31 Responses

  1. Bert Whetstone says:

    Thanks for the article! I was looking for a way to upload PNGs to my Remarkable with the assumption that I would be able to edit them. Apparently the editing part isn’t possible (other than making additions), but thanks to you I can at least get PNGs on there.

    • Kyra says:

      Glad it helped. That would be so cool if it could edit PNGs.

      Not sure if it will help but if the image is simple I’ve once created a template from a PNG I wanted to copy, traced it, switched to a blank template, and then reorganized the drawing.

  2. Laura says:

    Thank you, Kyra! I followed your directions to a T. The file shows up, but the template is blank when I open it. Any suggestions?

    • Kyra says:

      The file shows up where? On your reMarkable when ssh in? The template is available to choose on your reMarkable but not showing up properly when chosen?

      If showing on your reMarkable template pages that means it seems your JSON changes. If the template is blank?… Is it a PNG file (did a test and the reMarkable shows the PNG and not the SVG)? Is it located where your JSON entry says (for example if you just have the filename – no extension- in the JSON then it should be with all the others and not inside a directory there)? Did you type the filename in correctly?

      Sorry those are the only questions I can think of when debugging from afar.

      • Laura says:

        Thank you so much for the response. I got interrupted when I was sending you the message and apologize for my poor description. In spite of it though, you did manage to steer me in the correct direction! I managed to put the file in my new directory but didn’t manage to update the file path. When I put a copy in with ALL the templates, it worked without issue. 🙂 Thank you again! Really appreciate all your help and your response! Terrific directions and thankful that you figured out how to make this tool more useful! Love it, wish it had a “tiny” bit more integration with things… but it’s way better than a million paper notebooks or pieces of paper!

  3. You might not need to mess with SSH to do this.

    A quick tip: You can use Filezilla for the files part. I just used filezilla and dropping the files onto the remarkable and editing the json file. The best part is the filezilla can save your creds and you can log on anytime:

    Protocole: SFTP – SSH File Transfer Protocol
    User: root
    Password: [Your Password]

    You can’t do the reboot via filezilla, but after everything is on there I’m sure you can just turn your remarkable off then on again.

    Makes life a lot easier to manage this with an interface vs trying to fuss with command line. I love command line, but just about anything done with an interface is usually faster.

    • Kyra says:

      Thanks for sharing. I had heard of using FileZilla and WinSCP but hadn’t delved too far into either yet so that’s really useful.

      • Great news! I just confirmed you can turn the remarkable off and on again and you can skip the command to reboot the system.

        I got my template on without even touching the terminal.

        Here’s a basic tutorial on filezilla. Just use the information in my original post when following this guys video:

      • Russ says:

        Have you managed to get custom templates working after the most recent update?

        • Kyra says:

          Haven’t updated my reMarkable recently but auto-update is on. Which version are you asking about? When I get a chance I’ll check if I have it or not.

        • The most recent update clears your templates back to default. All you have to do is follow the same procedure and re add them.

          • Kyra says:

            Yes. Each time there’s an update any custom changes (template and sleep screen images) are reset. Just repeat this process. If you don’t change the names your notebooks will be hooked up again. If you do change the name you’ll need to manually connect each page.

  4. Jen-Francoooo Messier says:

    Great article and great content. I just want to see the other articles. And hopefully, I should be able to find the RSS link. I recognize WordPress……………. Have a great day 🙂

    • Kyra says:

      Thanks. I haven’t set up an RSS link by at the bottom you can sign up for emails. That said I publish a wide range from this to food to sewing to kids.

  5. Lucas says:

    I had some difficulty converting a single page US letter sized PDF to a template on my Remarkable 1, so for reference, here are commands that worked for me using ghostscript and imagemagick (convert):

    gs -sDEVICE=pnggray -o ./output-600.png -r600 ./input.pdf
    convert output-600.png -density 226 -units pixelsperinch output.png
    convert output.png -resize 1404×1872\! output.png

    I tried using ghostscript to encode it at 226dpi, but it looked a bit blocky. For some reason, just resizing it without changing the DPI caused the device to reject the files. Also of note: when I flipped the width/height dimensions, it still worked as a template, but was highly distorted.

    Hopefully some collection of those commands are useful for others.

  6. Alan says:

    Kyra – very impressed with the detail and explanation of how to make this work. Thank you.

  7. kitty visser says:

    hello do you already know how to add costum icons

  8. Debra Deppeler says:

    Update: I created the matching svg for my template using Inkscape. But, still no custom icon for my template, and template image still doesn’t show in the App on my laptop.

    • Kyra says:

      So far I haven’t used SVG files and only PNGs. That said I heard somewhere the SVG files are for exporting your notebook since SVG files can be made bigger without going blurry (I think SVG are vector images instead of pixel based so they don’t lose their quality but I haven’t done too much research).

      Since custom images aren’t supported they don’t show up in the apps at all. I got around it with one of my notebooks by exporting it as a PDF and having both versions on my reMarkable (notebook if I want to change it and PDF for the apps). That said, if I want to update it I’ll have to export it again.

      Also as templates aren’t supported there’s a limited amount custom images (iconcode) to use as the templates icon. I haven’t looked into whether you can add more (guessing rather complicated) and have just chosen one to repeat each time I add a custom template.

      With the template wipe when it updates. I’ve found if you keep the details the same (filename, category, etc) then when you re-upload them the reMarkable’s notebooks can still find the right templates without you having to go in and re-add them. It makes it a bit easier. Not sure, specifically, which details need to be the same as I haven’t played with that yet.

      Hope that helps. I’m so glad my post was able to help you out and if you have any other questions feel free to ask.

  9. Debra Deppeler says:

    It worked. I was able to edit the week PNG and make my own weekly template. Disappointed to learn that it wont be viewable in the APP. My guess is that I would have to have a matching svg file for the png file. I may try that for a different template. For now, this is a great addition to my rM 2 even if I must repeat parts of the process after each software update.

    Thanks again for the great instructions.

  1. March 31, 2021

    […] learning, and posting, about how you can upload a PNG image to your reMarkable to use as a template I realized I wanted […]

  2. July 27, 2021

    […] Since posting about how I connected to my device, changed out the default sleep screen image, and added my own custom templates I’ve also written a bash script that makes my custom templates so much easier to upload. […]

  3. January 1, 2022

    […] since come out with a video that combines several posts together including connecting via SSH, uploading the templates manually, and my bash script. You can find it here. If you’d like to simply update your sleep screen […]

  4. January 1, 2022

    […] Before using this script I recommend you get comfortable uploading a PNG to your reMarkable and editing the JSON file yourself. This way you can better understand what I did, more easily edit the script to fit your specific case(s), and troubleshoot any issues that may pop up. Before working on this script I first learned how to connect to my reMarkable2 via ssh through my terminal, changed my reMarkable2’s default sleep screen image, and then manually uploaded my custom PNG template. […]

  5. October 4, 2022

    […] since come out with a video that combines several posts together including connecting via SSH, uploading the templates manually, and my bash script. You can find it […]

  6. October 17, 2022

    […] So far I’ve mainly created my custom template image files by exporting a PDF I already have so each page becomes a PNG file. I then use these image files as my custom templates. You could also use GIMP, Canva, or other methods to create the images themselves. After connecting to your reMarkable you then upload the images, edit the templates.json file, and restart my device so the changes take effect. For help connecting you can check out my Learn How to Access Your reMarkable Through the Command Line post and for the custom templates themselves you can follow along in my How to Make Template Files for Your reMarkable. […]

  7. October 22, 2022

    […] almost a year ago, and figuring out how to connect to my device, change out my sleep screen image, upload custom templates, writing my own script to make the entire process simpler (part one and two), and handling […]

Leave a Reply

Your email address will not be published. Required fields are marked *

CommentLuv badge

This site uses Akismet to reduce spam. Learn how your comment data is processed.

%d bloggers like this: