Skip to content

Latest commit

 

History

History
72 lines (65 loc) · 5.5 KB

FEATURES.md

File metadata and controls

72 lines (65 loc) · 5.5 KB

ScreenshotTile Features List

Note: Some of these features depend on a minimum or maximum Android version.

Screenshot Capture Methods

  • Legacy Method (Android 7.0+): Uses screen recording capabilities (MediaProjection) to capture a single frame.
  • Native Method - System Defaults (Android 9.0+): Triggers the system's default screenshot mechanism (identical to physical button shortcuts) from an AccessibilityService.
  • Native Method - Custom (Android 11.0+): Uses AccessibilityService#takeScreenshot for full control over the capture and saving process without relying on system defaults.

Triggers & Interfaces

  • Quick Settings Tile: The primary interface for quickly capturing screenshots from the notification shade.
  • Floating Button:
    • Customizable: Adjustable size, transparency (alpha), and color.
    • Positioning: Draggable anywhere on the screen; remembers different positions for portrait and landscape orientations.
    • Camera notch: Tap camera to take screenshot. Option to hide the floating button behind the camera notch.
    • Multi-Action Support: Configurable actions for single tap, double tap, and long press (e.g., Take Screenshot, Partial Screenshot, Open Settings).
    • App Filtering: Can be set to auto-hide or auto-show only in specific applications (Whitelist/Blacklist).
    • Auto-Hide: Automatically hides during the screenshot process or after a screenshot is taken.
    • Visibility Controls: Options to show/hide on the lockscreen or when Quick Settings are open.
  • Home Screen Widgets: Provides widgets for Screenshot capture, Settings access, and Floating Button toggle.
  • Digital Assistant: Can be set as the device's default Digital Assistant app, allowing screenshots to be triggered via assistant shortcuts (e.g., long-pressing the home button).
  • Broadcast Intents (Automation): Integration with apps like Tasker or MacroDroid using a password-protected broadcast action (com.github.cvzi.screenshottile.SCREENSHOT). Tutorial Video.
  • App Functions (Android 15+): Integration with system-level shortcuts and AI assistants like Gemini for voice-triggered capture.
  • Terminal / ADB: Ability to trigger (remote) captures via command line with broadcast actions or by starting a trigger-activity (com.github.cvzi.screenshottile.TAKE_SCREENSHOT).

Capture Options

  • Partial Screenshot: Interactive area selector to crop and capture only a specific part of the screen.
  • Auto-Crop: Pre-configure fixed margins (Top, Bottom, Left, Right) to automatically crop every screenshot.
  • Delay Timer: Configurable delay before capture
    • Countdown Display: Optional visual on-screen countdown timer.
    • Tap to Cancel: Quickly cancel a pending screenshot during the countdown.
  • Shutter Sound: Play a tone upon successful capture.

Saving & Storage

  • Custom Formats: Support for PNG, JPEG and WEBP.
  • Image Quality: Adjustable compression levels for JPEG and WEBP formats.
  • Custom Naming Patterns: Use placeholders to automate file naming:
    • %timestamp%: Current date and time.
    • %counter%: Sequential number.
    • %randint% / %random%: Random numbers or UUIDs.
    • %app% / %package%: Name or package ID of the foreground app.
  • Custom Storage Location: Save screenshots to any folder, SD card or cloud storage.
  • Private App Storage: Option to save screenshots only within the app's private data folder to keep them out of the public gallery.
  • History Management:
    • Internal gallery/history of recent screenshots.
    • Automatic cleanup of old files.

Post-Capture Actions

  • Notifications: Configurable notification buttons for immediate actions: Share, Edit, Rename, Crop, Delete, Details, and Photo Editor.
  • Clipboard: Copy the captured screenshot directly to the clipboard for easy pasting into other apps.
  • Built-in Image Editor:
    • Drawing: Freehand drawing with custom colors and brush sizes.
    • Text: Add text overlays with various colors.
    • Emojis: Insert emojis directly onto the screenshot.
    • Filters: Apply image filters like Grayscale, Sepia, Blur, etc.
    • Eraser: Tool to remove edits.
    • Undo/Redo: Full history of edits.
    • Auto-Rotate: Automatically rotates landscape screenshots for easier editing.
    • Overwrite Option: Choose to overwrite the original screenshot or save the edited version as a new file.
  • Quick Rename: Dedicated activity to rename screenshots with:
    • Suggestions for ISO and Local date formats.
    • List of recently used names.
    • "Starred" names for frequent use.
    • Move the file to recently used directories.

App Settings & Maintenance

  • Backup & Restore: Full export and import of all application settings to a file.
  • Theming: Support for Light and Dark theme.
  • Localization: Languages not natively supported by Android system can be activated in the in-app language switcher. Help with translations is welcome: crowdin.com
  • Hide Launcher Icon: Option to hide the app icon from the app drawer.
  • Permission Guide: Integrated status checks, notifications for lost permissions and shortcuts to system permissions.
  • Restricted Settings Bypass: In-app instructions for enabling Accessibility services on Android 13+ devices where they might be restricted.