Class Timetable

A weekly class timetable and course schedule in the sidebar, on desktop and mobile. And a way into the notes behind each class.

Class times are stored in your notes' own frontmatter, not in plugin settings. Rename a folder, move a note, or edit the YAML by hand: the timetable follows. Nothing lives in a place Obsidian can't see.

▶ Try it in your browser — no install

The real plugin, on a made-up timetable. Drag a class to move it, click one to open its shelves, switch the language — it runs the same main.js the release ships, not a mock-up of it. Nothing is uploaded and no network request is made.

Or install Class Timetable from Settings → Community plugins.

What's new in 2.0

• Three tabs: Today, Week and To-do. Today reads your day from top to bottom, with the class in progress on a card (time left, today's note, its shelves) and free periods between classes. Use the arrows to look at another day.
• A to-do list in the sidebar. Type and press Enter. A to-do can belong to a class (it's written to that note's todo:) or to nothing (it stays in the plugin's settings — no file is created). - [ ] checkboxes you write in lecture notes show up too, grouped by class, and ticking one here ticks it in the note.
• Paste your timetable. Copy rows from your school portal, a spreadsheet or a note — Statistics Mon,Wed 10:30-12:00 Room 301 — and every class is created at once, with a folder, a folder note and a lecture-notes folder. Or pick an .ics file exported from your calendar.
• Export to your phone's calendar. One .ics file with the semester's classes (cancelled days left out) and every exam and open deadline, each with a reminder the day before.
• Semesters. Start a new semester… keeps this term's classes where they are and starts the next one empty. Switch back any time.
• Classes done. On a class's shelves, one dot per class held this semester — filled when that day's note exists, a ring when you ticked it off without a note (2.2). Click an empty dot to write the note, right-click it to tick it off.
• Readable in a narrow sidebar. Names are never broken mid-word; long words are shortened (Organic Chemist.), and split columns show a short name. Set your own with short:.
• Small things: the current class in the status bar, a reminder a few minutes before class, Undo after moving or cancelling a class, and a shorter right-click menu.

What it does

A timetable in the sidebar. Real clock times on the vertical axis, not period numbers. Overlapping classes split the column instead of hiding each other. The current time is marked, and the top bar counts down to the end of the class you're in — or to whatever comes next. When the day is done it says so instead of counting.

Click a class, get its shelves. Obsidian can't "open a folder", so the plugin opens a view of one: the folders belonging to that class, laid out like a bookshelf. Square cards are folders, wide cards are files. A note's card shows the day of its lecture: a date: property if it has one, else a date in its name (like the 0914 of a note made from the timetable), else the day it was last edited. Create, rename and delete them right there — names are typed in place, on the card itself.

Start today's note in one step. Right-click a class → Open today's note, press Today's note on its shelves, or bind a hotkey to Create today's note for the current class. The file name and body come from a template you define ({{course}}, {{date:MMDD}}, {{dow}}, {{week}} …). If today's note already exists, it opens instead of being overwritten. Right-click a class on another day and the menu names that day instead — Open the note for 10/5 (Mon) — and that is the date the note gets.

Every week is not the same week. The arrows above the grid step through weeks; the label shows the dates and, once you set a semester start, the week number. Right-click a class to mark that one day as cancelled — it stays in place, struck through, and stops counting as your next class. A class that only meets every other week takes odd or even. Set a semester end and the classes stop being drawn after it. List days without classes — holidays, exam weeks, reading weeks — and every class on those days is struck through at once, with the day's name above it.

Exams and deadlines, where you will see them. Write them under exam: and due: in the class note, or give each assignment a note of its own with New assignment note. They sit under the day they fall on, and the next ones are listed above the grid with the days left. A deadline you missed does not quietly disappear: it stays at the top in red — 2d late — until you mark it done. Done items keep their record, struck through on their day. Click one to open its note.

Classes with no set time. An online class may never meet at a fixed hour. In the class editor, press × on its last time and save: it leaves the grid and sits in a row below it. Click it for its shelves, right-click to add a deadline or edit it. Its exams, deadlines and to-dos work like any other class. In frontmatter this is schedule: [].

The timetable inside a note. A class-timetable code block draws the same week in a daily note or a dashboard — or just the list of what is coming up.

See where you are in the day. The class in progress is outlined and fills up as it goes; classes already over today step back. The shelves say whether you're in class now or when the next session is.

Plans, without files. Some things don't deserve a note — a shift, a study group, a dentist appointment. Add them straight onto the grid. A one-time plan carries the date it disappears on, and removes itself once that time has passed.

Share your week as an image. Save as PNG or Copy image from the gear, the view's ⋯ menu, or the command palette. The whole week is drawn at full size in your current theme — no cropping by a narrow sidebar, no scrolling — ready to send to a group chat. Saved images go to your attachments folder.

One day at a time, when you want it. The Today tab lists the day in order — the class in progress on a card with the time left, free periods between classes, and what is due that day.

Four languages. English, 한국어, 中文, 日本語 — picked from Obsidian's own language on first run, switchable at runtime, no restart. What gets written to your files never changes with the language: weekdays are always stored as 월 화 수 목 금 토 일, only the display is translated.

How a class is defined

Any note with a schedule: field becomes a class. That's the whole contract.

---
schedule:
  - 월 10:30-12:00 @ Room 301
  - 수 10:30-12:00 @ Room 301
---

Everything else is optional:

Times are read generously: 월, 월요일, mon, m, 月, 一 all work, as do 9, 9:00, 09:00 and 0900.

Biweekly classes, cancelled days, exams and deadlines

---
schedule:
  - mon 10:30-12:00 @ Room 301
  - wed 10:30-12:00 odd @ Lab 2     # odd weeks only; `even` for the others
exam:
  - 2026-10-22 13:00-15:00 Midterm
due:
  - 2026-10-08 Reading response ✓  # done
  - 2026-10-15 Problem set 1
cancelled:
  - 2026-10-05
checked:
  - 2026-10-12                     # ticked off without a note
---

You rarely type any of this. Edit class has an every week / odd weeks / even weeks choice per time, the right-click menu has Mark 10/5 (Mon) as cancelled and Add an exam or deadline…, and right-clicking a deadline has Mark as done.

• Odd and even weeks are counted from the Semester start in Settings — that week is week 1. The edit window tells you which kind this week is, so you do not pick the wrong one.
• A date is enough for an exam or a deadline. A time (13:00 or 13:00-15:00) and a name are read if they are there.
• Done is a mark, not a deletion. Mark as done adds a ✓ to the end of the line (or done: true to an assignment note). The item leaves the upcoming list and stays on its day, struck through. Mark as not done takes it back.
• Missed deadlines stay. An unfinished deadline that has passed is listed first, in red, until you mark it done — for up to 30 days, so last term's leftovers do not pile up. Exams leave the list once their day is over.
• An assignment note can carry its own deadline. A note with due: 2026-10-15 in its frontmatter, anywhere inside a course's folder, shows up as that course's deadline under the note's name. If the course is a plain note rather than a folder note, name the course in the assignment: course: Linear Algebra.
• New assignment note (on a course's shelves, in the command palette, or as a checkbox in Add an exam or deadline…) writes that note for you: named after the assignment, with due: and a course: link filled in. It goes into the course's assignments folder if it has one (assignments, homework, 과제, 作业, 課題 …), otherwise into the course folder. No folder is ever created for you.
• Tick off a class without a note. Not every class needs a note — some only need you to fill in an attendance form, others a weekly report. Once a class has started, tick the round box on its row in the Today tab, right-click it → Tick off, or right-click its dot on the class's shelves. It's written to checked: and counts the same as a class with a note; leave it unticked until the report is in. Click again to untick.
• Upcoming lists the next 14 days above the grid. The gear changes that to 7 or 30 days, or hides it.

To-do

The To-do tab puts everything you have to do in one list, sorted by when: Overdue · Today · Coming up · Anytime, then the checkboxes from your notes, then what you've finished (folded, with Clear done).

• Your own to-dos. Type in the box at the top and press Enter. Tap the box to pick a class and a date first — or leave both empty.
  • With a class, it is written to that class note: todo: [2026-10-22 Make the slides]. It syncs with your notes.
  • Without one, it lives in the plugin's data.json — no file is created. Finished ones clean themselves up after a week.
• Checkboxes in your notes. Any - [ ] line in a note inside a class's folders is listed under that class. Click the text to jump to the line; tick it and the note's line becomes - [x]. A Tasks-style 📅 2026-10-22 date is read. Turn this off in Settings if you don't want it.
• Exams and deadlines stand in the same list, so there is one place to look. The tab shows a red count of what is due by today.
• Right-click (or ⋯) a to-do to change its date, open its note, turn it into a deadline for that class, or delete it — deleting can be undone from the notice.

The Today tab lists the day's to-dos under the classes, and a class's shelves list that class's to-dos beside its notes.

Bring in a timetable you already have

Plus → Add your whole timetable, or the empty timetable's first button. Paste one class per line — the parser is forgiving:

Statistics Mon,Wed 10:30-12:00 Room 301
Linear Algebra Tue 9:00-10:15 @ Hall B
Psychology | Thu 13:00-15:00 | Room 101
통계학 월수 10:30-12:00 301호

Days can be Mon/Wed, Mon,Wed, 월수 or 月水; times 9-10:30 or 0900-1030; columns separated by spaces, tabs (a spreadsheet copy) or |. A line with only a name followed by lines with only times works too. You see every class before anything is created, and lines that could not be read are shown in red. A class with the same name as an existing one only gets the new times.

The .ics tab reads weekly repeating events from a calendar export; every-other-week events become odd/even weeks. Nothing is fetched — you pick a file.

Export to a calendar

Gear → Export to calendar (.ics), or the command. The file goes to your attachments folder: the semester's classes as weekly events from the semester start to its end (16 weeks if no end is set), with cancelled days and days without classes left out, plus every exam and unfinished deadline with a reminder the day before. Import it in Google Calendar, Apple Calendar or Outlook.

Semesters

Settings → Semester keeps each semester's name, start, end and days without classes. Start a new semester… writes the current semester's name into semester: on its classes (nothing else changes, no note moves), then switches to the new one with an empty timetable. Pick a past semester from the list to look at it again.

A class that only runs for half the semester stays in the same semester: give it its own dates under Edit class → Runs (from: · until:). It is drawn only on those dates, left out of the calendar export outside them, and two classes at the same hour in different halves do not count as overlapping.

Lectures and practice sessions of one subject can be two class notes in the same folder, each with its own notes: folder and its own note template (Edit class → Note template).

Days without classes

Settings → Days without classes, one per line — a date or a range, with an optional name:

2026-11-26 Thanksgiving
2026-10-19 ~ 2026-10-23 Reading week

Every class on those days is drawn struck through, the name sits above the day, and next class and today's note skip them. Nothing is written to your class notes. To cancel just one class on one day, right-click it instead.

The timetable inside a note

```class-timetable
```

An empty block draws this week. It is the same timetable as the sidebar, read-only: step through weeks, click a class for its shelves, click a deadline for its note. Options go inside the block, one per line:

Insert timetable into note and Insert upcoming exams and deadlines into note in the command palette write the block for you.

Getting started

The timetable opens in the right sidebar the first time the plugin is enabled. After that, it's on the ribbon (calendar icon) and in the command palette.

Just looking? Press Try a sample timetable on the empty timetable (or run Create a sample timetable). Five made-up classes appear in a Timetable sample folder, with shelves to click through. Remove the sample timetable sends that one folder to the trash when you're done.

Your own week:

1. Press Paste your timetable and paste the rows you already have — or Add a class, or click the pencil to unlock editing and drag on an empty cell. Editing is locked by default so a stray click can't move your week.
2. Pick the note or folder the class belongs to. The times are written into that note's frontmatter.
3. Click a class block to open its shelves; right-click for today's note, shortcuts and settings.

In Settings you can point the plugin at one or more course folders so it only scans those, set the current semester with its start and end dates, and edit templates. The gear in the timetable's top bar holds the display options: language and the hours the grid shows. The timetable follows Obsidian's light or dark theme.

Commands

Editing

Finer times than 15 minutes are typed in by hand, on purpose — a shaky drag should not produce a class that starts at 11:47.

Dragging a class changes its weekly time, whichever week you are looking at. A one-time plan belongs to the week you drew it in.

When a change would overlap another class or plan, a confirmation appears before anything is written, listing everything it collides with. An odd-week class and an even-week class at the same hour do not collide. Overlaps found while scanning (someone else's sync, hand-edited YAML) are only outlined in red — no dialog interrupts your typing.

Mouse, touch and pen are all handled, so editing works the same on a tablet.

Changing Course note under Edit class moves the class: its times, exams, deadlines, cancelled days and to-dos go to the new note or folder, and the old note stops being a class. A note or folder that already belongs to another class can't be picked.

Install

From the community plugin browser: Settings → Community plugins → Browse → "Class Timetable" → Install.

Manually: download main.js, manifest.json and styles.css from the latest release, put them in <your vault>/.obsidian/plugins/class-timetable/, then reload Obsidian and enable Class Timetable in Settings → Community plugins.

Desktop and mobile both. The timetable is the same on a phone; editing is handled for touch and pen as well as the mouse.

Notes on data

Classes live in your notes — and so do their exams, deadlines, to-dos and cancelled days. Plans, to-dos that belong to no class, saved semesters and days without classes live in the plugin's data.json, since they have no file of their own — which also means they don't sync between devices the way your notes do.

The only edit the plugin makes to a note's body is ticking a - [ ] checkbox you ticked in the To-do tab: that one [ ] becomes [x]. Everything else is frontmatter.

Nothing is ever deleted without asking. Remove from timetable clears only the schedule: field; the note and its folder stay.

The plugin makes no network requests and collects nothing. It only writes to the clipboard when you press Copy image, and never reads from it.

Feedback

Something broken, or something your semester needs that is not here? Report a bug or suggest a feature — the same two links are at the bottom of the plugin's settings. Questions and setups go in Discussions. 한국어로 적으셔도 됩니다.

More from the same author

• Vault Orrery: your vault as a 3D galaxy, where every folder is a solar system. Replay how it grew, note by note.
• Vault Pet: a pixel cat that lives at the bottom of your workspace and levels up as you write.
• Tag Graph: a graph view for Bases where tags, folders and properties become hubs. Tag, retag and merge by dragging.
• Download Pulse: download stats for plugin authors: every plugin's downloads, rank and milestones in one dashboard.

한국어

수업 시간표를 옵시디언 사이드바에 상시 띄워 두고, 블록을 누르면 그 수업의 폴더들이 책장처럼 펼쳐집니다. 시간 정보는 플러그인 설정이 아니라 노트의 frontmatter에 저장되므로 폴더를 옮기거나 이름을 바꿔도 깨지지 않습니다.

schedule: 한 줄만 있으면 어떤 노트든 수업이 됩니다. 폴더노트 구조를 쓰지 않아도 되고, 메모 한 장으로 쓰셔도 됩니다.

---
schedule:
  - 월 10:30-12:00 @ 301호
---

처음 켜면 시간표가 오른쪽 사이드바에 열립니다. 먼저 둘러보고 싶다면 빈 시간표의 예시 시간표 불러오기를 누르세요. 다섯 과목짜리 예시가 시간표 예시 폴더에 만들어지고, 다 보면 예시 시간표 지우기 명령으로 한 번에 치울 수 있습니다.

수업 중에는 지금 수업의 오늘 노트 만들기 명령(단축키 지정 가능)이나 책장의 ＋ 오늘 노트 버튼으로 템플릿에 맞춘 필기 노트를 바로 엽니다.

격자 위의 화살표로 지난주·다음 주를 넘겨 볼 수 있습니다. 수업을 우클릭하면 그 날 하루만 휴강으로 표시할 수 있고, 격주 수업은 시간 뒤에 odd(홀수 주)·even(짝수 주)을 붙입니다. 설정에 학기 시작일·종료일을 적으면 주차가 표시되고, 종료일 뒤에는 수업을 그리지 않습니다.

시험과 과제 마감은 수업 노트의 exam: · due: 에 한 줄씩 적습니다(우클릭 → 시험·마감 추가… 로도 됩니다). 그 날짜의 요일 아래에 뜨고, 가까운 것은 시간표 위에 D-day 와 함께 나옵니다. 과제 노트에 due: 2026-10-15 만 적어도, 그 노트가 수업 폴더 안에 있으면 마감으로 잡힙니다.

---
schedule:
  - 월 10:30-12:00 @ 301호
  - 수 10:30-12:00 odd @ 301호
exam:
  - 2026-10-22 13:00 중간고사
due:
  - 2026-10-15 과제 1
cancelled:
  - 2026-10-05
checked:
  - 2026-10-12
---

노트가 필요 없는 수업(출석 설문만 하는 수업, 주간 리포트를 내는 수업)은 노트 없이 체크할 수 있습니다. 시작한 수업이면 오늘 탭의 그 줄에 있는 동그라미를 누르거나, 우클릭 → 수업 체크 (노트 없이), 책장의 점을 우클릭하세요. checked: 에 날짜가 적히고 노트를 남긴 수업처럼 셉니다. 리포트를 낼 때까지는 비워 두면 됩니다.

끝낸 마감은 우클릭 → 완료로 표시를 누르면 줄 끝에 ✓가 붙고(과제 노트라면 done: true), 다가오는 목록에서 빠진 채 그 날짜 칸에 줄 그은 채로 남습니다. 완료로 표시하지 않은 마감은 날짜가 지나도 사라지지 않고 "2일 지남"으로 목록 맨 위에 빨갛게 남습니다(최대 30일). 과제를 노트 한 장으로 관리하고 싶다면 수업 책장의 ＋ 과제 노트나 새 과제 노트 명령을 쓰세요. 과제 이름으로 노트를 만들고 due: 와 course: 를 채워 줍니다. 수업 폴더 안에 과제·assignments 같은 폴더가 있으면 그 안에 만듭니다.

공휴일·시험 주간처럼 모든 수업이 쉬는 날은 설정의 수업 없는 날에 한 줄씩 적습니다(2026-10-09 한글날, 2026-10-20 ~ 2026-10-24 중간고사 주간). 그 날의 수업은 한꺼번에 줄이 그어지고, 요일 위에 이름이 뜹니다. 수업 노트에는 아무것도 쓰지 않습니다.

노트 안에 시간표를 넣으려면 class-timetable 코드블록을 씁니다. 빈 블록이면 이번 주가 나오고, view: today · view: upcoming · height: 420 같은 옵션을 한 줄씩 적을 수 있습니다.

2.0 — 사이드바가 오늘 · 주간 · 할 일 세 탭으로 나뉩니다. 오늘은 하루를 위에서 아래로 읽고(지금 수업 카드 · 남은 시간 · 공강), 할 일은 지난 마감 · 오늘 · 다가오는 것 · 언제든 · 노트 속 체크박스를 한 목록에 모읍니다. 칸에 적고 Enter 하면 끝이고, 수업을 고르면 그 수업 노트의 todo: 에, 고르지 않으면 설정에만 남습니다(파일을 만들지 않습니다). 강의 노트에 적은 - [ ] 도 여기 모이고, 여기서 체크하면 노트의 줄도 [x] 가 됩니다.

포털 · 엑셀에 있는 시간표는 ＋ → 시간표 한 번에 등록에 붙여넣으세요(통계학 월수 10:30-12:00 301호). 캘린더의 .ics 파일도 읽고, 반대로 학기 시간표와 시험 · 마감(하루 전 알림)을 .ics 로 내보내 휴대폰 캘린더에 넣을 수 있습니다. 학기가 바뀌면 설정의 새 학기 시작… — 지난 학기 수업은 그대로 보관되고 새 학기는 빈 시간표로 시작합니다. 책장에는 수업마다 수업 기록(수업이 열린 날마다 점 하나, 노트가 있으면 채운 점, 노트 없이 체크했으면 굵은 고리)이 보입니다.

버그나 필요한 기능은 설정 맨 아래 의견 보내기로 알려 주세요.

톱니 → PNG로 저장 / 이미지 복사로 한 주 전체를 지금 테마 색 그대로 그림으로 뽑을 수 있습니다. 사이드바가 좁아도 잘리지 않고, 저장한 그림은 첨부 파일 폴더에 들어갑니다.

화면 언어는 처음에 옵시디언 언어를 따라 정해지고, 환경설정(톱니)에서 한국어·English·中文·日本語 중에 바꾸실 수 있습니다. 파일에 저장되는 요일 표기는 언어와 무관하게 항상 월 화 수 목 금 토 일입니다.

License

MIT