This tool is no longer maintained as @alicekaerast no longer uses the iOffice system. The tool was still working as of last commit, but there is clear scope for improvement which might be easier with a clean implementation

Lists and creates reservations of spaces (desks/rooms) in iOffice

This tool is not created by, affiliate with, or supported by iOffice

1. create ioffice.yaml in either your $HOME directory or ~/.config/ (or this directory if working from source code)
2. Set up your authentication (see Auth section next)
3. Set your instance's hostname (example in https://example.ioffice.com)

This section assumes you have downloaded the application from the latest release and have installed this to somewhere in $PATH. If you are running this from source code, replace ioffice with go run . in the below documentation.

• Run the application to get a list of your future bookings (ioffice)
• Book a named room by passing in a date and a room name (ioffice create -l 2101 2022-03-13)
• Cancel or check in to your reservation by passing its ID (ioffice checkin 68610 or ioffice cancel 68610)
• See available buildings (ioffice buildings)
• Get a floor ID to use for checking occupancy (ioffice floors -b 46)
• See occupancy of a floor (ioffice occupancy -f 2)

If you do not use SSO then you just need to add your username and password to ioffice.yaml, otherwise read on.

IOffice API currently can only handle simple auth. However, the frontend can actually use an SSO provider. If you have a non-SSO account then change username and password to your username and password. Otherwise you will need to manually login via the UI to your SSO provider and pass the authentication. Once this has been done, inspect your cookies for ACTID - set this as your session. This will allow this application to work even with SSO providing the session is active.

Note We prioritize session over username and password. So if you have a non-SSO account and want to avoid session then ensure it is set to blank "" value.

You might have the same room names in multiple offices. If this is the case then you can set the building that you work in.

1. Run ioffice buildings to get a list of building IDs and names
2. Set buildingID in the yaml file to the ID of the building you work in

All reservations will now use only this building. You can override the building when making reservations with ioffice create -b 46 -l 3035 2023-10-31, where 46 is a building ID and 3035 is the name of a location

iOffice publish API documentation that helps figure out new functionality. It's inaccurate or plain wrong in places, but you can use dev tools in your browser to watch what API calls the web app makes. If you feel like fixing the documentation, you can raise a PR against it.

To build and install locally: make install (assuming you have Go already installed). You may need to do this if your Mac blocks unsigned applications from running.

To release a new version:

1. Get your code into the main branch (via a PR if you're not a collaborator, ideally conventional commit messages)
2. Create a git tag with the new desired version number (follow SemVer)
3. Push your git tag (git push --tags)
4. Go Releaser will create a new release
5. If you're happy the release is stable, change it from a pre-release to a full release