Ao
Elegant Microsoft To-Do desktop app
## Description
Ao is an unofficial, featureful, open source, community-driven, free Microsoft To-Do app, used by people in more than [120 countries](https://snapcraft.io/ao).
Read this document in: [Deutsch](https://github.com/klaudiosinani/ao/blob/master/docs/i18n/readme.GER.md).
You can now support the development process through [GitHub Sponsors](https://github.com/sponsors/klaudiosinani).
Visit the [contributing guidelines](https://github.com/klaudiosinani/ao/blob/master/contributing.md#translating-documentation) to learn more on how to translate this document into more languages.
You can find more apps [here](#related-apps).
## Highlights
- Black, Dark & Sepia Themes
- Compact & Auto-Night Modes
- Local & Global Customizable Keyboard Shortcuts
- List Navigation
- Scalable Interface
- Update Notifications
- Cross Platform
## Contents
- [Description](#description)
- [Highlights](#highlights)
- [Install](#install)
- [Features](#features)
- [Keyboard Shortcuts](#keyboard-shortcuts)
- [Development](#development)
- [Related Apps](#related-apps)
- [Team](#team)
- [Sponsors](#sponsors)
- [Disclaimer](#disclaimer)
- [License](#license)
## Install
#### Github Releases
Head to the [releases](https://github.com/klaudiosinani/ao/releases/latest) page and download the appropriate installer for your system.
#### Snapcraft
Ubuntu Linux users can directly install through [`Snapcraft`](https://snapcraft.io/ao) `snap install ao`
#### Homebrew
Macos users can directly install through [`Homebrew Cask`](https://caskroom.github.io/) `brew cask install ao`
#### Note
The version available on `Homebrew Cask` may not be the latest, since unlike `Snapcraft`, it is not offically maintained. If that is the case, please consider downloading directly from the [Github releases](https://github.com/klaudiosinani/ao/releases/latest) page.
## Features
Visit the project [homepage](https://klaudiosinani.com/ao) to view all features in detail.
- Auto Night Mode - Press Cmd/Ctrl Alt N to allow Tusk to adjust to your environment.
- Black Theme - Activate it by pressing Cmd/Ctrl B
- Compact Mode - Downsize the window to enter the mode.
- Custom Shortcut Keys - Navigate to `~/.ao.json` or press Cmd/Ctrl . to modify any shortcut key. To reset delete `~/.ao.json` & restart the app.
- Dark Theme -Activate it by pressing Cmd/Ctrl H
- Global Shortcut Keys - Enable them by using the `File` > `Enable Global Shortcut Keys` option.
- List Navigation - Navigate your lists by pressing Cmd/Ctrl Tab / Cmd/Ctrl Shift Tab or jump directly to one by using Cmd/Ctrl 1 - 9
- Scalable Interface - Adjust the zooming factor by pressing Cmd/Ctrl Shift = or Cmd/Ctrl -.
- Sepia Theme - Activate it by pressing Cmd/Ctrl G.
- Update Notifications - Customize the app's update checking frequency.
## Keyboard Shortcuts
### Local Shortcut Keys
40+ local keyboard shortcuts. Toggle anything in a flash.
Description | Keys
-------------------------- | --------------------------
Activate Auto Night Mode | Cmd/Ctrl Alt N
Add Due Date | Cmd/Ctrl Shift T
Add Todo to My Day | Cmd/Ctrl K
Complete Todo | Cmd/Ctrl Shift N
Delete List | Cmd/Ctrl Shift D
Delete Todo | Cmd/Ctrl D
Edit Shortcut Keys | Cmd/Ctrl .
Hide Completed Todos | Cmd/Ctrl Shift H
Jump to List | Cmd/Ctrl 1 - 9
Make Text Larger | Cmd/Ctrl Shift =
Make Text Smaller | Cmd/Ctrl -
Navigate to Next List | Cmd/Ctrl Tab
New List | Cmd/Ctrl L
New Todo | Cmd/Ctrl N
Rename List | Cmd/Ctrl Y
Rename Todo | Cmd/Ctrl T
Reset Zoom Level | Cmd/Ctrl 0
Return to Todos | Esc
Search Todos | Cmd/Ctrl F
Set Always on Top | Cmd/Ctrl Shift P
Set Reminder | Cmd/Ctrl Shift E
Sign out | Cmd/Ctrl Alt Q
Toggle Black Theme | Cmd/Ctrl B
Toggle Dark Theme | Cmd/Ctrl H
Toggle Important | Cmd/Ctrl I
Toggle My Day | Cmd/Ctrl M
Toggle Planned | Cmd/Ctrl P
Toggle Sepia Theme | Cmd/Ctrl G
Toggle Settings | Cmd/Ctrl ,
Toggle Sidebar | Cmd/Ctrl O
Toggle Tasks | Cmd/Ctrl J
Toggle Window Menu | Alt
### Global Shortcut Keys
Access Ao at any moment from anywhere within your operating system. All global shortcuts can be customized to match your own preference through the configuration file `~/.ao.json`.
Description | Global Shortcut
-------------------------- | --------------------------
Create New Todo | Cmd/Ctrl Alt C
Search Todos | Cmd/Ctrl Alt F
Toggle Ao Window | Cmd/Ctrl Alt A
## Development
For more info on how to contribute to the project, please read the [contributing guidelines](https://github.com/klaudiosinani/ao/blob/master/contributing.md).
- Fork the repository and clone it to your machine
- Navigate to your local fork `cd ao`
- Install the project dependencies `npm install` or `yarn install`
- Run Ao on dev mode `npm start` or `yarn start`
- Lint code for errors `npm test` or `yarn test`
- Build binaries and installers `npm run release` or `yarn release`
## Related Apps
- [Tusk](https://github.com/klaudiosinani/tusk) - Refined Evernote desktop app.
- [Taskbook](https://github.com/klaudiosinani/taskbook) - Tasks, boards & notes for the command-line habitat.
## Team
- Klaudio Sinani [(@klaudiosinani)](https://github.com/klaudiosinani)
- Mario Sinani [(@mariosinani)](https://github.com/mariosinani)
## Sponsors
A big thank you to all the people and companies supporting our Open Source work:
- [Better Stack: Spot, Resolve, and Prevent Downtime.](https://betterstack.com/)
## Disclaimer
Ao is an unofficial, open source, third-party, community-driven, free app and is not affiliated in any way with Microsoft.
## License
[MIT](https://github.com/klaudiosinani/ao/blob/master/license.md)
