Session notes and materials
This chapter describes how you take notes during a class, bring photos of the board, voice memos, videos and PDFs into a note, dictate, create notes without a course, keep permanent notes and open questions for a course, highlight passages of text and attach materials such as lecture notes, slides and photos to a course. How you put notes, highlights and materials together for an exam and find everything again is described in the chapter Collections, search and trash.
Three kinds of notes
Sapeluno knows three kinds of notes:
- Session note: the note for a single session, for example the lecture on Tuesday. It belongs to exactly this session and to its course.
- Course note: a permanent note for a course that grows over the whole semester, such as a formula sheet, a glossary or a summary.
- Open question: something you still want to clear up, for example in your lecturer's office hours. Once you have the answer, you set the question to Resolved.
Starting a session note
You create a session note in one step, even shortly before the lecture begins:
- Under Today, tap Session note on the session's card. If a lecture is running right now, the card is called Running now and shows this lecture, not the next one yet. Otherwise it is called Next session.
- In Calendar, open a session's sheet and tap Session note.
The editor opens immediately; course, session and date are already assigned. You find the session note again later through the session in the calendar and through the course under Study.
Quick capture
The round + button in the middle of the bottom bar (on a tablet at the top of the side bar) opens the same Capture menu in every main area. Session, file and flashcard are reachable everywhere. See Adding files and Flashcards.
For a session note you use these options in Capture:
- Task: the quick entry of a task (see Tasks and submissions).
- Note: opens the editor.
- Photo: opens the camera app, for example for a photo of the board.
- Voice memo: records a voice memo.
If a lecture is running right now, starts within the next 15 minutes or ended no more than 15 minutes ago, the sheet shows Goes to with the name of the session at the top. Note, photo and voice memo then land in the session note of this session; if there is none yet, Sapeluno creates it. A task gets the course of the session. If you choose No course instead, a separate note without a course is created (see Notes without a course).
After a photo or a voice memo, Sapeluno briefly shows which note it was saved to. With Open you jump straight into it. If you cancel the camera or discard the recording, Sapeluno does not create an empty note.
Choosing a course
Even without a running lecture you can capture directly into a course, for example in the evening at your desk when you are revising a lecture or photographing sketches on paper. Tap Choose course … and choose a course of the semester that is selected under Study. The sheet then offers two destinations:
- The last session of the course with name and date, for example “Analysis I, Tue, 20 Oct”: the last session that has already started today or took place in the 13 days before. It is preselected. Note, photo and voice memo land in its session note, as with a running lecture.
- Course note: note, photo and voice memo become a new course note in this course; photo and voice memo carry the date and time in the title.
If the course had no session in the last two weeks, only Course note is offered. In both cases a task gets the chosen course. You reach older sessions through the Calendar.
Notes without a course
Not everything belongs to a course: a reading tip from the canteen, an idea for your thesis or a note about flat hunting. You create such notes under Today with +, No course and Note, or under Study with Notes without course and the first line Add note.
Under Study you find all of these notes in the entry Notes without course. Like all other notes, they are searchable.
In the editor, a field at the top shows the course of a note or No course. If you tap it, you can assign the note to a course, move it to another course or detach it again with No course. A note that you give a course disappears from Notes without course and is then listed with the course. A session note, by contrast, always stays with its session; it has no such field.
Notes in a course
Under Study, the course details show three sections:
- Session notes and notes: all session notes, course notes and open questions of the course. Open questions are at the top so that you see them before the next office hours.
- Materials: the files, photos and links of the course (see Materials).
- Highlights: all highlighted passages from the notes of the course.
From here you also create a new course note or an open question.
The editor
A note opens full screen on the phone and on a tablet held in portrait. On a tablet held in landscape and in a wide window, the list of notes you opened it from sits next to the editor: the notes of the course or the Notes without course. The open note is marked there. Tapping another note saves the current one and opens the new one; Add note at the top of the list creates a new one in the same course. If you want the whole width for writing, the list icon at the top of the editor hides the list; the same button brings it back, and while it is hidden the arrow in the editor goes back. If you turn the tablet to portrait, only the editor with your text remains; in landscape the list reappears. If a note cannot be saved when switching, the app asks as it does when leaving.
At the top is the Title, below it the text. You write as in a word processor: bold text appears bold, a heading large, a list with bullets. You do not see control characters. The format bar above the keyboard can be scrolled sideways and offers:
- Dictate: the microphone right at the front (see Dictation)
- Insert: the paper clip, for Take a photo, From the gallery, Record a voice memo, Record a video, Video from the gallery and File or PDF
- Bold, Italic, Underline, Strikethrough and Code for the selected text; without a selection the formatting applies to what you type next
- Heading, Subheading, Small heading and Quote for the paragraph the cursor is in; a second tap turns it back into normal text
- Bulleted list, Numbered list and Checklist; with Outdent and Indent you move an item one level out or in
- Insert link, Table and Divider
- Undo and Redo
In a list, the Enter key starts the next item.
Tables
Table inserts a table with a header row and two columns at the cursor; the cursor is placed straight in the first cell. You edit a table directly in the text:
- Tap a cell and start writing, also with Dictate.
- Next on the keyboard (or the Enter key) jumps to the next cell; in the last cell a new row is created. With a connected keyboard this also works with Tab and Shift+Tab.
- Bold, Italic, Underline, Strikethrough, Code and Insert link apply to the selected text in the cell. Headings, lists, indenting, divider and insert are greyed out in a cell.
- If the cursor is in a cell, Table in the format bar opens the actions for this table: Insert row above, Insert row below, Insert column before, Insert column after, Delete row, Delete column, First row is a header and Delete table.
- Undo takes back every step, including typing in a cell.
- Tapping the text outside the table brings you back into the text.
- If a table is wider than the page, you scroll it sideways.
A cell holds one line of text; long entries wrap. Merging cells, column widths and a new highlight in a cell are not available yet; existing highlights in cells are preserved.
Formulas
Formula (the root sign in the format bar) opens a window in which you write a formula. Above it you immediately see how it looks.
- You write the formula in LaTeX, for example
E=mc^2or\frac{a}{b}. - Without LaTeX you use the buttons below: Structure (fraction, power, index, roots, sum, integral, limit, derivative, brackets, vector, matrix, case distinction, text), Greek, Operators and Relations and arrows. A button places the symbol at the cursor; with a template such as the fraction, the cursor is placed straight in the first field.
- On its own line sets the formula large and centred on its own line; otherwise it sits in the sentence at the cursor.
- Tapping a formula opens it again: you change it and tap Apply, or you tap Remove formula. Undo takes that back as well.
- In a table cell a formula always sits in the text of the cell. To change it, place the cursor directly after the formula and tap Formula.
- If a formula is incomplete or the app does not know a command, the window tells you. The formula stays as you wrote it and appears as text until you correct it.
- Search finds formulas through their LaTeX text. If you share the note,
formulas appear in it as
$…$within a sentence and as$$…$$on their own line.
The app saves inserted images, voice memos, videos and files as materials of the note; in the text they appear at the place where you inserted them.
If you share the note, the app passes it on as Markdown, that is as plain
text with characters such as # for headings and ** for bold. This way
it stays readable in other apps as well. Instead of an image it contains
[Image] and instead of a voice memo, a video or a file
[Attachment: name].
Notes from earlier versions open unchanged in the new editor: the characters of the old notation disappear, the formatting stays, and all highlights stay in place. Parts of a note that a newer version of Sapeluno wrote are shown by the app as a notice; such a note can only be read until the update and is not lost in the process.
With Read and Edit you switch between the reading view and editing. In the reading view you open links with a tap and tick off items of a checklist directly. In the reading view you play a voice memo with Play directly in the note and pause it with Pause. You open PDFs with Open directly in Sapeluno (see What happens to a file); videos and other files in a suitable app on your device.
Drawing and handwriting
With a stylus, such as the S Pen of a Samsung tablet, you write and draw directly in the note, between typed text and on the chosen paper:
- Below the text, the whole paper down to the bottom edge is writable. Just start writing: the first stroke creates a Drawing at the end of the note, further strokes are added, and the drawing grows as you write. There is no limit.
- Draw in the format bar inserts a drawing at the cursor, for example between two paragraphs. It also grows downwards as you keep writing.
- The stylus never scrolls; you scroll with your finger. If your hand rests on the screen while writing, it moves nothing: while you are writing with the stylus and shortly afterwards, a touch on the drawing counts as a resting hand.
- As soon as the note has a drawing, a bar at the right edge of the screen holds the current pen, the Eraser, the colours Black, Blue, Red and Green, Own colour and Draw with finger. It stays in place when scrolling. Black appears light in the dark theme.
- If you tap the current pen, the Pens open: Pen, Highlighter, Pencil (fine and grainy, pressure makes it darker), Fountain pen (wide or narrow depending on the writing direction), Marker (flat and opaque) and Watercolour brush. Each shows a sample stroke in the chosen colour. After erasing, a tap on the pen is enough to write with it again.
- Watercolour: strokes that you paint shortly after one another (within about six seconds) run into each other at their edges and mix their colours where they overlap. If you paint over them later, the new colour settles on the old one like a dry glaze.
- Own colour opens a colour picker with Hue, Saturation and
Brightness or a Hex value such as
#3366CC. Own colours stay as you chose them in the dark theme. Add to the palette remembers the colour; it is then listed under Own palette and is back with one tap. A long press removes it from the palette. - Own pens: in the Pens, New pen creates a pen to your liking. You give it a name, choose the Kind (pen, highlighter, pencil, fountain pen, marker or watercolour brush) and set Width, Opacity, Soft edges and, depending on the kind, Pressure changes the width, Pressure changes the opacity, Grain, Nib angle or Colours run into each other. A sample stroke shows the result immediately. The pen remembers the currently chosen colour. Own pens are listed without limit under Own pens; with the pen icon next to them you edit or delete them. What you have already drawn does not change. Own pens and colours are included in the backup. With the handle at the top of the bar you slide it up or down along the edge; it stays there, also in other notes and after a restart.
- The tip of the stroke is drawn a little ahead of the stylus while writing, so that the writing follows the stylus directly. Only what you really wrote is saved.
- Erasing also works without switching: with the eraser end of the stylus or with the side button pressed. The eraser removes whole strokes.
- Undo in the format bar takes back the last stroke or the last erasing, Redo restores it.
- The small × at the top right of a drawing removes it entirely; Undo takes that back as well.
The drawing adapts to the width and looks the same on phone and tablet, in portrait and landscape, in the reading view, in versions and in collections. It is part of the note and is included in the backup. Without handwriting recognition, search does not find a drawing. When sharing as Markdown, its place is taken by [Drawing]. An older version of Sapeluno shows a notice in its place and leaves the drawing unchanged.
Converting handwriting to text
Handwriting recognition is optional and initially off. You switch it on under Settings → Handwriting recognition. The item only exists on devices that are capable of recognition (Android phones and tablets); on other devices it is missing, and drawings simply stay drawings.
- First choose the language of your handwriting, Deutsch or English, and then switch on Recognise handwriting. For this, Sapeluno downloads a language pack from Google once (about 20 MB), also over mobile data.
- Recognition runs on your device with Google ML Kit. Your handwriting and your notes do not leave the device. ML Kit does, however, send details about the device and the app, error codes and the chosen language to Google. If you do not want that, leave recognition off.
- Switching it off deletes the language pack again. To change the language, switch recognition off, choose the other language and switch it on again.
If the language pack cannot be downloaded, Sapeluno states the reason. Afterwards you simply switch on Recognise handwriting once more:
- No connection to the download server: check the internet connection. A VPN, a private DNS or an ad blocker can also block Google's servers; switch it off briefly for the download.
- Not enough free storage: Sapeluno needs about 150 MB free before the download starts. The pack itself is about 20 MB but is unpacked as well, and Android needs a reserve of its own. Delete, for example, photos or apps that you no longer need.
- Error code with a number: try again later. If it keeps failing, tell support the error code; it helps to narrow things down. Sapeluno does not send the code itself.
You also see the reason under Settings → Device capabilities.
Once recognition is ready, every drawing in the editor has a text icon, Convert to text, at the top right next to the ×. It shows you the recognised text, line by line, as you wrote it. Check and correct it, then choose:
- Convert to text: the drawing is replaced by the text, one line per paragraph. Undo brings the drawing back.
- Keep drawing, text for search: the drawing stays as you wrote it; the text is stored invisibly alongside it so that search finds your handwriting.
The app does not recognise handwritten formulas; they stay a drawing. Anything painted with the highlighter or the watercolour brush is skipped during recognition; pen, pencil, fountain pen and marker are read.
Voice memos
Record a voice memo in the editor or Voice memo under Today starts the recording immediately. A counter shows the duration. Stop and save stores the recording in the note, Discard deletes it. If you tap Back during the recording, Sapeluno saves the recording instead of discarding it.
- The first time, Android asks whether Sapeluno may use the microphone. If you decline, the app explains this and offers App settings, where you can allow it later. Your note stays unchanged.
- Keep the app open during the recording; the screen stays on for this. If you switch to another app or turn the screen off, Sapeluno stops the recording and saves what has been recorded up to then.
- A recording lasts at most 60 minutes. After that it ends by itself and is saved.
- The recording stays only on your device, in the app's storage area.
Dictation
Dictate turns speech into text and inserts it at the cursor. Sapeluno uses your device's speech recognition for this, for example Google's. It records on its own and returns only the recognised text to Sapeluno; depending on the device and its settings, it processes the speech on the device or at its provider. Dictation starts only when you tap it.
If the device has no speech recognition, the app shows Dictation is not available on this device. If nothing was recognised, try again.
Videos, files and PDFs in a note
Record a video opens the camera app, Video from the gallery the Android picker, File or PDF the file picker. The limit of 50 MB per file applies here as well; the camera app stops a video at this limit. For longer recordings a link is the better choice.
Saving
You do not have to save anything: Sapeluno saves the note automatically while you write. An indicator in the editor shows the state:
- Saved: everything is secured.
- Saving …: the last change is being written right now.
- Saving failed: the change could not be secured. Tap Try again.
If a note contains data that this app version does not understand yet, it is preserved. Affected sections appear as placeholders; with an unknown document structure the whole note can only be read. With a suitable newer app version you can edit this content again.
If the app is interrupted, for example by a call, or Android closes it in the background, the last saved state is preserved. Before you open the gallery, the camera, the file picker, the recording or dictation from the editor, Sapeluno secures the changes. If that fails, the editor stays open with the error message.
Paper
Behind the text of a note lies a paper: Blank, Lined, Squared, Dotted or Staff. The lines follow the text size, so the text sits on the lines. Staff shows systems of five lines for writing music with the stylus; there the text does not sit on the lines. The paper belongs only to the view; the text, search, sharing as Markdown and the backup stay the same.
The app decides which paper a note shows in this order:
- The note itself: in the editor through the paper icon in the toolbar at the bottom or through ⋯ → Paper. There you choose one of the five papers or As course (…) or As default (…) so that the note follows the course or the default setting again.
- The course: on the course's page through ⋯ → Paper for notes, for example Dotted for mathematics or Staff for music theory. All session notes of the course without a paper of their own show it.
- The default: under Settings → Paper for notes. Initially this is Blank, so that existing notes look as before.
You set the size of the grid under Settings → Grid size, once for all papers on this device: Follows the text size (this is the initial setting, the text sits on the lines) or a fixed spacing from 4 to 10 mm, for example 5 mm for squares as in a school exercise book. With a fixed spacing the text no longer sits on the lines. The setting also applies to the paper of flashcards.
Versions, sharing and deleting
In the editor you also find:
- Versions: the last 50 saved versions of the note. Restore makes an older version the current text again.
- Export as PDF and Export as text: turn the note into a file that you can open or share in another app (see Exporting as PDF or text).
- Share as Markdown: passes the note on as text to another app, for example to an email or a messenger.
- Delete note: moves the note to the trash without asking and closes the editor (see Trash). It is quicker in the list of a course or under Notes without course: swipe the note to the left and let go as soon as Release: Delete appears. In both cases the app offers Undo at the bottom; this brings the note back with its highlights and attachments.
Exporting as PDF or text
Through ⋯ → Export as PDF the note becomes a PDF as you can print or hand in: the title as a heading, headings, bold, italic, underline, strikethrough, code, highlights, lists, tasks with checkboxes, tables, quotes and dividers. Links can be clicked in the PDF. Formulas and drawings look as they do in the app, drawings always in the light paper colours, even if you use the app in dark mode. Images are set at text width in the PDF; voice memos, videos and other files appear as a line with name and kind. At the bottom of each page is the page number, for example Page 1 of 3. The text stays selectable and searchable in the PDF.
If the note has a paper (lined, squared, dotted or staff), the app asks first: Plain white or On its paper. With blank there is nothing to choose.
⋯ → Export as text creates a plain text file (.txt): the title, an
empty line and the text of the note without formatting. Formulas appear
there as LaTeX source, drawings with their recognised text and attachments
with their caption.
While the file is being created, the app shows progress. Afterwards you have the choice:
- Open with …: opens the file in an app of your choice, for example in your PDF viewer.
- Share …: opens the device's share menu. There you can also save the file in Files or a cloud storage.
The file is kept only temporarily in the app and is replaced by the next export. It contains only the note, no details about you or your device.
You set the page size under Settings › PDF page size: A4, US Letter or Automatic. Automatic follows the region of your device, not the app language: US Letter for example in the USA, Canada and Mexico, otherwise A4. In brackets you see which size currently applies, such as Automatic (A4). The margin is 2 cm for both sizes.
Scripts for which the app does not bundle characters (for example Arabic or Hebrew) appear in the PDF as replacement characters; in the text file they are preserved.
Highlighting and tasks from the text
If you select text in a note, for example with a long press on a word, the bar above the selection offers two additional commands before Cut, Copy, Paste and Select all:
- Mark: highlights the passage. It appears in the course details under Highlights, is searchable and can be added to a collection.
- Create task: opens the quick entry of a task. The selected passage is the title, the course and exam of the note are prefilled. The task refers back to the note (see Tasks and submissions).
In the same way you turn an open question into a task, such as “Ask in office hours”.
If you change the text later, highlights move along with their passage. If you write in the middle of a highlighted passage, the new text belongs to the highlight; if you delete part of it, it becomes shorter. If you delete or overwrite the whole highlighted text, the highlight disappears as well. If you restore an earlier version of the note, its highlights come back with it.
You end a selection with a tap into the text, also after Select all.
Materials
Materials are files, photos and links that belong to a course, a class, a session, an exam or a note. In the course details you add something under Materials:
- Choose file: opens the Android file picker. You can choose PDF, Word, Excel, PowerPoint, images and other files, also from Downloads or a cloud folder that Android offers there.
- From the gallery: picks a photo.
- Take photo: opens the camera app, for example for a photo of the board.
- Add link: saves an address, such as to the learning platform or to a video.
Sapeluno does not ask for a storage or camera permission for this: you choose the file yourself in the Android picker, and the camera app takes photos and videos. Only for voice memos does Android ask once for the microphone.
If Android ends Sapeluno during the file, photo or camera selection, this import is interrupted. Saved notes and existing materials are preserved. Open the picker again after returning; the interrupted selection is not taken over automatically as a material.
Up to 50 MB per file
A file may be up to 50 MB in size. If it is larger, the app rejects it before copying anything and shows a message. For very large files, save a link instead.
What happens to a file
- The app copies the file into its own storage area. The original stays where it was; if you delete or change it there, the copy in Sapeluno stays unchanged.
- Images From the gallery and with Take photo are reduced by the app to at most 2560 pixels on the long side, and location details and other details in the photo are removed in the process. An image that you add through Choose file, by contrast, is copied unchanged, with all the details it contains.
- If you tap a PDF, it opens directly in Sapeluno: you page through the pages, zoom with two fingers, see Page 3 of 12 at the bottom right and can select and copy text. The magnifier at the top searches the text of the PDF and jumps from hit to hit with the arrows. A protected PDF asks once for the password; it is not saved. The ⋯ menu at the top contains Open in another app; with it you pass the PDF on to another viewer as before.
- Annotate (the pen at the top) switches writing on: with the stylus you write and draw directly on the pages, with all pens and colours from the bar at the edge, including watercolour and own pens. With your finger you keep paging and zooming. The eraser end, the side button and the eraser remove strokes; if the eraser touches a highlight, it is gone as well.
- Highlight: select text (long press and drag) and tap Highlight at the bottom left. The lines get a glowing stripe in the chosen colour; black becomes yellow in the process.
- Undo at the top takes back the last stroke, the last erasing or the last highlight.
- Sapeluno saves your annotations separately; the PDF file itself stays unchanged. If the PDF goes to the trash, its annotations go with it and come back when it is restored.
- Share with annotations in the ⋯ menu sends a copy of the PDF with your strokes and highlights to another app, such as a message or email. Your PDF in Sapeluno stays unchanged.
- Write into the PDF in the ⋯ menu writes your annotations permanently into the PDF file so that every app shows them. Sapeluno asks first and sets the original aside; it is also part of the backup. Afterwards the annotations are part of the pages and can no longer be erased individually in Sapeluno. You can add new annotations at any time and write them in again.
- Restore the original in the ⋯ menu brings the PDF back as it was before the first write. Your annotations appear separately again and can be edited as before.
- Pencil grain, fountain-pen shape and the running of the watercolour are shown only by Sapeluno. In a shared or written PDF these strokes are written as simple lines in their colour, width and opacity.
- Other materials open with a suitable installed app. If there is none, the app shows No app found to open this.
- You can rename a material, add it to a collection with Add to collection or put it in the trash with Delete material. In the list of a course you can also swipe a material to the left. In both cases Undo appears at the bottom.
How much space your materials take up is shown by the Storage topic in Settings (see Installation and data).
What is still missing
- converting a voice memo to text afterwards (dictation already works live)
- recording a whole lecture with the screen switched off
- playing videos directly in the app and skipping forwards and backwards in a voice memo
These features will follow in later versions.
