A browser extension to improve the filtering system in courses.aalto.fi.
Find a file
2025-03-22 14:01:48 +02:00
scripts implement mobile compatibility 2023-11-07 13:25:35 +02:00
src sync 2024-02-20 16:56:20 +02:00
.gitignore improve build guide and scripts 2023-10-31 17:46:51 +02:00
.prettierrc create course prefix filter 2023-10-27 18:21:17 +03:00
LICENSE fix bug with initial load 2023-10-28 21:08:44 +03:00
package.json chore: migrate to codeberg from github 2025-03-22 14:01:48 +02:00
permissions.gif update readme 2023-11-01 08:59:33 +02:00
preview.gif polish ux and code 2023-10-31 15:38:23 +02:00
README.md bump version 2023-11-07 13:27:11 +02:00
tsconfig.json implement mobile compatibility 2023-11-07 13:25:35 +02:00

courses-aalto-better-filters

Preview GIF displaying the extension in use

courses.aalto.fi has garbage-tier UX. This is a hack to try and improve specifically the filtration of the courses.

Features

  • Filtering courses by the prefix of the course code. Roughly speaking, this means filtering by which school department is responsible for the course.

  • Filtering by period. Filter by which period the course starts in.

  • Positive & negative filters. Positive filters display only courses matching the selected filter. Negative filters display courses that don't match the filter. Positives override negatives so negatives will only work if only negative filters of a certain filter type are selected.

  • Displaying period data in courses. courses.aalto does not display which period each course is held in. This extension adds that information to the course listing.

Building

This package is configured to use Bun.

bun install
bun run build

This compiles the TS files to JS and copies other files to the build folder. The manifest.json in build can then be used as the start point of the extension.

Running locally

Get familiarized with the WebExtensions docs.

bun run dev

to build compile JS files and watch for modifications.

bun run client

to run web-ext with Firefox developer edition. You can also run the extension in different ways as shown in this guide.

You can also use adb with web-ext to run the extension on Firefox for Android. See more here.

bun run client:mobile

The extension only has functionality in https://courses.aalto.fi. Once navigating there, the extension needs to be given permissions to run. This can be done by opening the extensions menu, opening the settings for the extension, and selecting "Always allow on courses.aalto.fi".

GIF displaying how to give permissions to the
extension