ZenTrate offers a clutter-free, elegant interface to streamline your digit al life and enhance productivity.

Features

• Customizable Launcher: ZenTrate.js is a productivity launcher that you can tailor to your needs. It supports adding apps, shortcuts, and other actions, all presented in a minimalist, distraction-free widget.
• Minimalist Calendar: ZenLendar.js provides a sleek, easy-to-read calendar widget that integrates seamlessly with ZenTrate.
• Theme Management: themes live in ZenTweak's editor (section Tema): tap a theme to apply it, long-press to edit colors, light/dark variants, font and sizes.
• Menu Editor: ZenTweak.js is our configuration editor: a fullscreen page with a live preview of the widget, a theme strip, drag-and-drop columns, schedules, and autosave, so you never edit JSON files directly.

Getting Started

1. Installation

1. Download and install the Scriptable app from the App Store.
2. Clone or download the ZenTrate repository from GitHub: ZenTrate Repository.
3. Copy the .js files (ZenTrate.js, ZenLendar.js, ZenDigest.js, ZenTweak.js) and the lib/ and config/ folders into Scriptable.
4. Optionally, copy the ZenThemes directory.

2. First Run

• When you run ZenTrate for the first time, it will create a default configuration file (zentrate_config.json) in your iCloud Scriptable documents directory. This file contains example items (apps and shortcuts) that you can customize.
• ZenLendar provides a minimalist calendar view for your home screen.
• If the ZenThemes folder is empty, ZenTweak creates a default theme (noir.json) there. You can duplicate and edit it, or create your own.

How to use

ZenTrate.js

• Customizing Items: Edit the zentrate_config.json file to add or remove items. Each item can be an app, shortcut, or any other action that supports a URL scheme.

• Sorting: Items can be sorted alphabetically or by usage frequency.

• Autosizing: The widget dynamically adjusts text size based on usage frequency, making more frequently used items more prominent.

ZenLendar.js

ZenLendar displays your calendar events in a clean, concise format. It integrates directly with ZenTrate, following the same minimal design principles.

Creating and Editing Themes

Themes apply to ZenTrate, ZenLendar and ZenDigest. Manage them in ZenTweak's Tema section.

• Apply a theme: tap its chip; the editor re-themes immediately. Pick Automático, Oscuro or Claro for the active theme.
• Edit a theme: long-press its chip (or tap Editar). Changes save as you make them; the contrast badge warns when text gets hard to read.
• Create a theme: + Nuevo duplicates the active theme as « copia» and opens it for editing.

Contributing

Contributions are welcome! Whether it's adding new themes, improving existing scripts, or suggesting new features, feel free to submit a pull request or open an issue.

Finding URL Schemes for Your Favorite Apps

To customize your launcher with specific apps, you need to know their URL schemes. Here's how to find them:

1. Download the app you want on your iOS device.
2. Plug it into the computer.
3. Download Apple Configurator 2 from the Mac App Store.
4. Right-click on your iOS device in Apple Configurator and press "Add" to find the app you want to download. Once you find it, double-click it (ignore any popup messages).
5. Go to ~/Library/Group Containers/K36BKF7T3D.group.com.apple.configurator/Library/Caches/Assets/TemporaryItems/MobileApps/
6. You should now see the .ipa file there. Change the extension to .zip and unzip it. Open the payload folder.
7. Go into the application's folder (Right-Click Show Package Contents on MacOS).
8. Open Info.plist and look for: URL Types key. One of the sub-keys in there will open the application.