# Set up UniOne

Six steps, about ten minutes. The app walks you through the same things the first time you open it. Web page: https://unione.study/setup

## 1. Install

Download UniOne from https://unione.study/get, open the file and drag UniOne to Applications. It is signed and notarised by Apple, so it opens on a double click. It needs a Mac with Apple silicon (M1 or later) and macOS 13 or later. There is no Windows version yet.

## 2. Create your account in the app

The first screen asks for your name, your email address and a password, typed twice.

- Your password needs 8 to 128 characters and cannot be your email address.
- It is kept only as a hash, so nobody can read it back, us included.
- Your email is how you sign in. We email it a 6-digit code from hello@mail.unione.study, subject "Your UniOne code", to confirm it is yours. Type the code into UniOne to finish; it works for 15 minutes, and Resend code sends a new one.
- Nothing else is emailed to you, apart from a code you ask for when you reset your password.

Set up UniOne with an invite code before? Your Mac stays activated. The app asks once for a password to keep your access, emails a 6-digit code to the address you gave with your code to confirm it, and links your account to the code you already used.

## 3. Connect Canvas

1. Open canvas.sydney.edu.au and sign in.
2. Go to Account, then Settings.
3. Scroll to Approved Integrations and choose New Access Token.
4. Give it a purpose, for example "UniOne". Expiry is your call.
5. Choose Generate Token and copy it now. Canvas will not show it again.
6. Paste it into UniOne. It goes into the macOS Keychain.

UniOne only reads your units, deadlines, marks, modules, files and announcements. It never submits, posts or changes anything. Treat the token like a password and delete it in Canvas if it ever leaks.

## 4. Add your timetable

1. Open Sydney Timetable and sign in.
2. Find the option to subscribe to or export your timetable.
3. Copy the calendar link and paste it into UniOne, or download the .ics file and drop it in.

A link updates itself when classes change. A file is a snapshot.

## 5. Choose a notes folder

Pick a folder. UniOne keeps your notes in it as plain Markdown files, one folder per unit. Obsidian can open the same folder.

## 6. Add a Claude key, if you want AI

Only the AI features need one. Everything else works without a key, and one switch in Settings hides every AI feature.

1. Go to console.anthropic.com and create an account, or sign in.
2. Add a small amount of credit under Billing.
3. Open API Keys, choose Create Key, name it "UniOne" and copy it.
4. Paste it into UniOne. It goes into the Keychain.

Requests go straight from your Mac to Anthropic, and before anything from your units is sent, UniOne shows exactly what will go. A Claude Pro or Max subscription cannot be used by apps.

## Forgot your password

We email you a 6-digit code to choose a new password.

1. In UniOne, choose Forgot password on the sign-in screen and enter your email address.
2. Find the email from hello@mail.unione.study, subject "Reset your UniOne password", and enter its 6-digit code.
3. Choose a new password and type it twice.

The code works for 15 minutes. Setting a new password signs your other Macs out. Nothing arrived? Check your junk folder, then press Resend code; a new code can go once a minute.

If email is not getting through, Josh can still make a one-time reset code by hand: email hello@unione.study. Choose Forgot password, then Have a reset code from Josh?, and enter it with a new password. That code works once and expires after three days. Once Josh has made one for you, your old password stops working.

## Signed out?

UniOne checks that your account is still active when it opens, and about once a day while you are online. Offline, it keeps working for up to 7 days. If your account has been deactivated, the app signs you out at its next check and says so. Your notes folder is untouched either way.

## Revoking access

- Canvas: Account, Settings, Approved Integrations, then delete the token.
- Claude: console.anthropic.com, API Keys, then disable or delete the key.
- This Mac: Settings, Account, then Sign out.

## Removing everything

1. Revoke your Canvas token and Claude key.
2. Move UniOne to the Bin and remove ~/Library/Application Support/com.joshbotha.unione.
3. Delete your notes folder, or keep it.

To delete your account, ask Josh at hello@unione.study. That removes your email, your name, your password hash and the list of your Macs, and signs every Mac out.

## For agents

- The steps above match UniOne 0.6.0, the first version with accounts. Earlier versions used invite codes; their holders keep access and add an email and password once.
- A forgotten password is reset with a 6-digit code emailed from hello@mail.unione.study (sent through Resend). Josh can still make a one-time reset code by hand as a fallback, asked for at hello@unione.study.
- Sign-up is confirmed with a 6-digit code emailed to the address; the account cannot sign in until it is typed back.

## Limits

- UniOne is a student project, in beta. It is not affiliated with, endorsed by, or connected to the University of Sydney.