> ## Documentation Index
> Fetch the complete documentation index at: https://www.tella.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Mac App

> What's new in the Tella macOS app.

<Update label="July 14, 2026">
  ## 2.29

  * Added a setting to control automatic update checks
  * The app window now snaps to your camera's aspect ratio while resizing
  * Clearer error message when window resizing fails
</Update>

<Update label="June 24, 2026">
  ## 2.28

  * Uploads now recover automatically if credentials expire mid-upload
  * Warns when you start recording while Low Power Mode is on
</Update>

<Update label="June 18, 2026">
  ## 2.27

  * Fixed screen recording resolution limits for non-16:9 displays
</Update>

<Update label="June 16, 2026">
  ## 2.26

  * More reliable recording stop/finish handling during server errors
  * Added a new "Natural" teleprompter speed option
</Update>

<Update label="June 10, 2026">
  ## 2.25

  * Fixed the microphone level meter for multi-channel audio interfaces
</Update>

<Update label="June 3, 2026">
  ## 2.24

  * Microphone selection can now recover a session that failed to start
  * Device warnings only show for devices actually being recorded
  * Camera and microphone button labels now reflect your selection more accurately
  * Prevents starting a recording with no valid device selected
</Update>

<Update label="June 1, 2026">
  ## 2.23.1

  *Stability and performance improvements.*
</Update>

<Update label="May 27, 2026">
  ## 2.23

  *Stability and performance improvements.*
</Update>

<Update label="May 26, 2026">
  ## 2.22

  * Camera preview now switches to mini mode automatically when the camera is disabled
  * Settings now explain how Quick mode works
</Update>

<Update label="May 19, 2026">
  ## 2.21

  * Refined camera preview design
  * Fixed Studio Display cameras that failed to start
  * Fixed a feedback loop when rapidly toggling Center Stage
  * Added a portrait effect toggle for the camera
  * Improved camera resolution switching
</Update>

<Update label="May 12, 2026">
  ## 2.20

  * Quick mode preference now syncs across devices
  * Prevents selecting cameras with no usable video format
</Update>

<Update label="May 6, 2026">
  ## 2.19

  * Fixed a crash when canceling a recording before it fully started
  * Fixed a crash during screen capture in certain conditions
</Update>

<Update label="April 14, 2026">
  ## 2.18

  * Reduced memory usage when uploading recordings
</Update>

<Update label="April 7, 2026">
  ## 2.17

  * Fixed a launch crash when the Uploads folder couldn't be created
  * Fixed a crash caused by concurrent update checks
</Update>

<Update label="March 25, 2026">
  ## 2.16

  * Fixed stream availability incorrectly resetting when the device list changed
</Update>

<Update label="March 24, 2026">
  ## 2.15

  * Added a status bar menu with recording controls
  * Fixed upload streams incorrectly showing as done during active recording
  * Fixed Upload Activity summary bar clipping under the title bar
  * Window size now persists across quit and relaunch
  * Added a Video Effect button to open the system video effects menu
</Update>

<Update label="March 16, 2026">
  ## 2.14

  * Added an Upload Activity window to track upload progress (Cmd+U to toggle)
  * Shows clear error messages when uploads fail or credentials can't be fetched
  * Upload streams now show recording labels
  * Failed upload credentials are retried automatically on reconnect
</Update>

<Update label="March 6, 2026">
  ## 2.13

  * Upload streams now show device names
  * Recording-interruption alerts now float above other windows
  * Paused time no longer counts toward the recording limit
  * Added a 6-hour recording limit for paid users
</Update>

<Update label="March 3, 2026">
  ## 2.12

  *Stability and performance improvements.*
</Update>

<Update label="March 3, 2026">
  ## 2.11.1

  *Stability and performance improvements.*
</Update>

<Update label="March 2, 2026">
  ## 2.11

  * Fixed an upload reliability issue affecting file transfer tracking
</Update>

<Update label="February 25, 2026">
  ## 2.10

  * Fixed external cameras spontaneously flipping to portrait format
  * Help menu now opens the Tella help center
  * Moved the display label position in the cover view
</Update>

<Update label="February 23, 2026">
  ## 2.9

  * Fixed window resizing when opening or closing the settings overlay
</Update>

<Update label="February 18, 2026">
  ## 2.8.2

  *Stability and performance improvements.*
</Update>

<Update label="February 11, 2026">
  ## 2.8.1

  *Stability and performance improvements.*
</Update>

<Update label="February 5, 2026">
  ## 2.8

  *Stability and performance improvements.*
</Update>

<Update label="January 28, 2026">
  ## 2.7.1

  *Stability and performance improvements.*
</Update>

<Update label="January 27, 2026">
  ## 2.7

  * Fixed the menu not appearing over full-screen windows
  * Fixed window size and position not being restored correctly
</Update>

<Update label="January 20, 2026">
  ## 2.6

  * Tella's window is now resizable, with the UI adjusting responsively
  * Fixed toggling your camera off and back on
  * Removed camera landscape mode
</Update>

<Update label="January 16, 2026">
  ## 2.5

  * Added a submenu to quickly switch workspaces, with an overlay shown while switching
</Update>

<Update label="January 14, 2026">
  ## 2.4

  * Added a warning when using a virtual webcam
  * Improved error messages
</Update>

<Update label="December 11, 2025">
  ## 2.3

  * Added a warning when recording without a display
  * Fixed a bug that could slow down display recording
</Update>

<Update label="December 11, 2025">
  ## 2.2.1

  * Added Quick Mode for faster screen recording
  * Improved cursor detection accuracy
</Update>

<Update label="December 9, 2025">
  ## 2.1

  * Improved detection of macOS cursors
  * Countdown animation is smoother, and you can now cancel a recording during the countdown
  * Screen crop now snaps to the pixel grid for sharper recordings
</Update>

<Update label="December 3, 2025">
  ## 2.0.1

  * You can now drag a window by its label
</Update>

<Update label="December 3, 2025">
  ## 2.0

  * New countdown view with sounds, and a keyboard shortcut to cancel it
  * Windows now center themselves while resizing
  * Added a maximize button to the resize menu
  * Added the option to dim the screen around your selected display
  * Fixed the menu position on secondary displays
  * Fixed the scale factor for cropped display recordings
</Update>

<Update label="November 28, 2025">
  ## 1.81

  * Recorded cursor types are now sent along with mouse events
  * Added a warning for lower-resolution (720p) camera recording
</Update>

<Update label="November 28, 2025">
  ## 1.80

  * Added a warning for the MacBook Pro M4 built-in camera
</Update>

<Update label="November 19, 2025">
  ## 1.79

  * Active subscriptions no longer have a recording time limit
  * Recording now waits for the display/window list to load instead of failing to start
</Update>

<Update label="October 28, 2025">
  ## 1.78

  * New borderless design with bigger, easier-to-hit buttons
  * Your camera now locks in place when starting a session or switching devices
</Update>

<Update label="October 21, 2025">
  ## 1.77

  * Uploads now use a new, more reliable storage location
</Update>

<Update label="October 15, 2025">
  ## 1.76

  * Improved camera format selection for better quality and orientation handling
</Update>

<Update label="October 13, 2025">
  ## 1.75

  * Fixed paywall styling on older macOS versions
</Update>

<Update label="October 8, 2025">
  ## 1.73

  * Hid the small purple ScreenCaptureKit indicator on macOS Tahoe
  * Displays are now sorted by their on-screen position
  * Fixed the landscape camera preview height on Tahoe
  * Fixed toggles jumping on hover on macOS Tahoe
  * Added a menu option to reset tokens
</Update>

<Update label="October 1, 2025">
  ## 1.72

  * Fixed the window shifting down when toggling mini mode on macOS 26
  * Camera preview now matches the active recording configuration
</Update>

<Update label="September 26, 2025">
  ## 1.71

  *Stability and performance improvements.*
</Update>

<Update label="September 25, 2025">
  ## 1.70

  * Added a new app icon for macOS Tahoe, with a fallback on older versions
  * Fixed top menu appearance on Tahoe
  * Cropping a display recording can no longer extend past the edge of the screen
  * Screen crop now snaps to the pixel grid
  * Fixed corner radius rendering on Tahoe
</Update>

<Update label="September 24, 2025">
  ## 1.69

  * Recording setup now remembers your last used display and camera
  * Added a progress indicator for slow app startup
</Update>

<Update label="August 28, 2025">
  ## 1.67

  * Fixed an issue that could cause partial uploads of recording segments
</Update>

<Update label="July 25, 2025">
  ## 1.66.3

  * Fixed a crash related to microphone audio
</Update>

<Update label="July 25, 2025">
  ## 1.66.2

  * Added a workaround for a microphone audio crash some users experienced
</Update>

<Update label="July 23, 2025">
  ## 1.66.1

  * Fixed a default app visibility setting
</Update>

<Update label="July 23, 2025">
  ## 1.66

  * Fixed crashes related to pausing recordings
  * Quick Preferences now shows top options in mini mode
  * Improved upload reliability when only some parts finish
</Update>

<Update label="July 23, 2025">
  ## 1.65.2

  * Fixed pausing issues
  * Added MotivMix to the list of supported audio loopback apps
</Update>

<Update label="July 17, 2025">
  ## 1.65.1

  * Fixed an issue with out-of-order video frames
</Update>

<Update label="July 17, 2025">
  ## 1.65

  *Stability and performance improvements.*
</Update>

<Update label="July 16, 2025">
  ## 1.64

  * Added a keyboard shortcut to pause and resume recording
  * Improved the pause overlay and resume button styling
  * Simplified the recording timer display
</Update>

<Update label="July 7, 2025">
  ## 1.62

  * Fixed an error where cancelling an upload could fail with a missing file error
</Update>

<Update label="June 30, 2025">
  ## 1.61.2

  *Stability and performance improvements.*
</Update>

<Update label="June 30, 2025">
  ## 1.61.1

  *Stability and performance improvements.*
</Update>

<Update label="June 24, 2025">
  ## 1.61

  * Renamed Preferences to Settings
  * Prevented camera format changes while recording
  * Added microphone delay settings, adjustable in milliseconds and saved per device
  * Advanced microphone options now only appear when applicable
</Update>

<Update label="June 4, 2025">
  ## 1.60

  * Fixed a crash that could occur when taking a screenshot of a window
  * Fixed incorrect timestamps in mouse event tracking
  * The app now displays your configured app name instead of a hardcoded name
</Update>

<Update label="May 27, 2025">
  ## 1.58

  * Enabled window recording through the improved recording engine
  * Clip status now shows the name of longer clips without overflowing
  * Fixed a crash that could occur from recording state changes
</Update>

<Update label="May 22, 2025">
  ## 1.57

  * Fixed an issue with multichannel microphones
</Update>

<Update label="May 21, 2025">
  ## 1.56

  * Fixed an issue with multichannel microphones
</Update>

<Update label="May 20, 2025">
  ## 1.55

  * Kept the green recording border visible when the app isn't active
  * Fixed an issue where the app could open off-screen when starting without a camera preview
  * Added the ability to exclude specific apps from audio loopback and screen recording overlays
</Update>

<Update label="May 12, 2025">
  ## 1.54

  * Improved reliability of screen, camera, and microphone recording
  * Applied maximum video dimensions when recording the camera
  * Fixed incorrect quality labels for camera settings
  * Added the ability to exclude Grammarly from screen recordings
</Update>

<Update label="May 6, 2025">
  ## 1.53

  * The main app window can now appear above fullscreen apps
</Update>

<Update label="May 1, 2025">
  ## 1.52

  * Added an alert when login fails
  * Improved logout handling on authentication errors
</Update>

<Update label="April 29, 2025">
  ## 1.51

  * Fixed menu button styling on macOS 13 Ventura
  * The countdown, cropper, speaker notes, and border windows can now appear above fullscreen apps and on all Spaces
  * Fixed Quick Settings styling on macOS 13 Ventura
</Update>

<Update label="April 17, 2025">
  ## 1.50

  * The app no longer alerts or logs an error when you manually stop screen recording from macOS's system controls
  * Fixed "Select Area" button styling
  * Added an animation to the record button when toggling states
</Update>

<Update label="April 16, 2025">
  ## 1.49

  * Redesigned the Preview button and its behavior
  * Added an audio indicator in the top bar while recording
  * Added a timer and clip status to the top bar
  * Updated the recording button design
</Update>

<Update label="April 14, 2025">
  ## 1.48.4

  *Stability and performance improvements.*
</Update>

<Update label="April 14, 2025">
  ## 1.48.2

  * The app now logs out automatically if your session becomes invalid
  * Fixed a hover bug affecting mouse interactions
  * Added a low disk space warning if a recording fails to save
</Update>

<Update label="April 9, 2025">
  ## 1.48

  * Added support for beta app updates
  * Added a live screen preview showing what's being captured, with a preview toggle in Settings
  * Improved screenshot rendering for the screen/window selection picker on macOS 13
</Update>

<Update label="April 2, 2025">
  ## 1.47.1

  * Fixed camera preview flickering
</Update>

<Update label="April 2, 2025">
  ## 1.47

  * Improved the hover state and styling of Quick Preferences
  * The app can now be launched via URL even if no main window is open
  * The app no longer closes the main window when launched at login
</Update>

<Update label="March 26, 2025">
  ## 1.46

  * Added a low disk space alert when stopping a recording
  * Fixed an issue where stopping a screen recording could loop while resending frames
</Update>

<Update label="March 25, 2025">
  ## 1.45

  *Stability and performance improvements.*
</Update>

<Update label="March 24, 2025">
  ## 1.44

  * Added customizable keyboard shortcuts for common actions.
  * Fixed recording start/stop via keyboard shortcut triggering before your camera, microphone, and screen were ready.
  * Server errors now show full details in the alert.
  * Minor UI polish to the settings button and transitions.
</Update>

<Update label="March 10, 2025">
  ## 1.43.4

  * Fixed an issue where a stale sample from a previous microphone could incorrectly affect the silent-microphone warning.
</Update>

<Update label="February 28, 2025">
  ## 1.43.3

  * Fixed a bug that could cause recordings to be silent right after previewing the microphone.
</Update>

<Update label="February 18, 2025">
  ## 1.43

  * Show the correct error message when aborting a recording.
  * Fixed a microphone preview issue.
</Update>

<Update label="February 17, 2025">
  ## 1.42

  * Recording now aborts cleanly if a critical error occurs while writing the file.
  * Switched support from live chat to email.
  * Added an audio level indicator to the microphone button.
  * Fixed the audio level indicator going out of bounds.
</Update>

<Update label="February 11, 2025">
  ## 1.41

  * Improved keeping your Mac awake during recording.
</Update>

<Update label="February 6, 2025">
  ## 1.40

  *Stability and performance improvements.*
</Update>

<Update label="January 20, 2025">
  ## 1.39

  * Added an audio level indicator to the microphone button.
  * Fixed the audio level indicator going out of bounds.
  * Improved the audio level indicator's appearance.
</Update>

<Update label="January 10, 2025">
  ## 1.38.2

  *Stability and performance improvements.*
</Update>

<Update label="December 19, 2024">
  ## 1.38.1

  *Stability and performance improvements.*
</Update>

<Update label="December 18, 2024">
  ## 1.38

  * Fixed the "Uploads in progress" prompt showing when there was nothing left to upload.
</Update>

<Update label="December 11, 2024">
  ## 1.37

  * Recording now checks for a valid session before starting.
</Update>

<Update label="November 26, 2024">
  ## 1.36

  * Added a warning when macOS Voice Isolation is enabled on Sequoia, since it can affect recordings.
  * Fixed the camera getting stuck when its format couldn't be changed.
</Update>

<Update label="November 12, 2024">
  ## 1.35

  *Stability and performance improvements.*
</Update>

<Update label="October 31, 2024">
  ## 1.34

  * Fixed the microphone not being detected when the MacBook lid is closed.
</Update>

<Update label="October 31, 2024">
  ## 1.33

  * Uploads now retry automatically after a failure.
</Update>

<Update label="October 30, 2024">
  ## 1.32

  * Fixed device buttons so clicking the right side re-enables that device.
  * Added a "gather logs" option to the Help menu.
</Update>

<Update label="October 23, 2024">
  ## 1.31

  *Stability and performance improvements.*
</Update>

<Update label="October 15, 2024">
  ## 1.30

  * Fixed handling of a device disconnecting during the countdown or start of a recording.
  * Show a clearer error message when a recording stops due to a network error.
  * Requests that fail due to network errors are now automatically retried.
  * Recordings now always stop locally, even if the network request fails.
</Update>

<Update label="October 7, 2024">
  ## 1.29

  * Added speaker notes with an auto-scrolling teleprompter, adjustable text size and transparency.
  * Added a screen highlight option to visually mark the selected screen while recording, with a full-screen selector.
  * Added a recording status pill showing idle and in-progress states.
  * Added options to skip the countdown or choose which screen it appears on.
  * Added a warning before discarding a recorded video.
  * Fixed the speaker notes transparency default and a crash when notes were larger than the view.
</Update>

<Update label="September 25, 2024">
  ## 1.28

  * Introduced Quick Preferences and a redesigned Preferences window, including launch-at-login and countdown sound options.
  * Added support for recording your mouse and keyboard input alongside screen, camera, and microphone.
  * Added clip re-recording and a two-hour recording limit.
  * Added audio loopback support for WaveLink and RODE Connect, plus a warning when no microphone sound is detected.
  * Added a Presenter Overlay, colored recording borders, and support for recording a specific window.
  * Various camera, upload, and stability fixes.
</Update>