Skip to content

matteoveglia/AstraNotes

Repository files navigation

AstraNotes

AstraNotes is a desktop app, for Windows and macOS, that integrates with ftrack to provide an better experience for note taking.

Features

  • 🎬 Broad Playlist Support: Browse, view and create ftrack client review and list playlists.
  • 📂 Project Selection: Quickly switch between ftrack projects.
  • ✍️ Note Creation: Create, edit, and publish notes on versions.
  • 🏷️ Label Support: Categorise notes with customizable labels pulled from ftrack.
  • ⚙️ Status Management: View and update shot and version statuses directly.
  • 📊 Quick Notes: Create notes on any version, on the fly, without a playlist.
  • 🔄 Smooth Updates: At the touch of button pull in new ftrack playlists and changes to an existing playlist
  • 🔍 Version Search: Find and manually add specific versions to playlists, on the fly, without affecting ftrack.
  • 💾 Offline Persistence: Draft notes offline and publish when connected, all data is stored locally on device.
  • 📤 CSV Export: Export notes to CSV
  • 🖼️ Thumbnail Previews
  • 🔄 Auto-updates
  • 🌙 Dark Mode

Roadmap

  • User Mentions: Support @-mentioning users within notes.
  • Multiple Notes per Version: Allow adding new notes to versions that already have published notes.
  • Related Versions: Feature to display related versions (from the same shot), including their shot and version status.
  • Open Playlist in Ftrack: Provide a direct link/button to open the current playlist in ftrack (completed, v0.8.0).
  • Project Selection: Allow users to quickly switch between ftrack projects (completed, v0.10.0).
  • Playlist Creation & Sync: Create new playlists, sync to ftrack, and generate playlists from quick notes (completed, v0.10.0).
  • Performance Optimizations: React Concurrent Mode implementation for faster, more responsive UI (completed, v0.11.0).
  • Playlist Name Conflict Handling: Real-time validation and user-friendly conflict resolution (completed, v0.11.0).

Installation

Requirements

  • Windows 10/11 or macOS 10.13+
  • ftrack credentials (API key, server URL, and user)

Download

Download the latest release for your platform:

Configuration

AstraNotes requires ftrack credentials for authentication. Upon first launch, you'll need to configure:

  1. ftrack Server URL: Your ftrack instance URL (e.g., https://yourcompany.ftrackapp.com)
  2. API Key: Your ftrack API key
  3. API User: Your ftrack username (email)

For compatibility details, see Ftrack API Objects & Attributes.

These settings can be updated anytime through the settings panel.

Development

For detailed development instructions, see Development Guide.

Troubleshooting

Common Issues

  • Connection Error: Verify your ftrack credentials in Settings
  • Missing Thumbnails: Check your connection to ftrack or reload the playlist

Logs

AstraNotes logs can be exported from the Settings panel for troubleshooting. Click "Export Logs" to save a log file with the last 24 hours of activity.

🛡️ Security

VirusTotal Scan

AstraNotes has been scanned with VirusTotal to ensure it's free from malware and other security threats.

You can view the scan results here, for release v0.10.0.

Windows

  • File Hash: 5a3f775c6ea3f0e79dc403e29e998d85ae86eb4ec28793282aceb7f563144fc5
  • Scan Results: View on VirusTotal

macOS

  • File Hash: 58bc687900dbc581562768af720735bd504eda1c12142c5e132f269648fd7308
  • Scan Results: View on VirusTotal

We are committed to providing a secure application and regularly scan our releases to ensure your safety.

Credits

AstraNotes is developed by Astra Lumen Images.

License

Copyright © 2025 Astra Lumen Images Inc. All rights reserved.

About

Note-taking app for ftrack

Topics

Resources

License

Stars

Watchers

Forks