Skip to content

cvzi/ScreenshotTile

Repository files navigation

app icon ScreenshotTile (NoRoot)

License: GPL v3 F-Droid Play Store Download APK file Downloads F-Droid build status πŸ”¨ Gradle Build

Get it on F-Droid            Consider donating to F-Droid

Screenshot Tile for Android 7.0+ without requiring root access

Video:

Video screenshot

Fork of github.com/ipcjs/ScreenshotTile

Table of Contents

Changelog β€’ View older releases β€’ Google store

Languages

To help translate this app, please visit crowdin.com, where the localizations are managed. If you like to add a new language, please open an issue or email me and I will add it.

Crowdin | Agile localization for tech companies

You may translate the resource files directly and open a pull request. The English source is in /app/src/main/res/values/strings.xml and the translated files are stored in /app/src/main/res/values-XX/strings.xml (XX = language code)

Contributors & libraries

Contributors

The internal image editor and image library used is github.com/burhanrashid52/PhotoEditor (MIT license) by Burhanuddin Rashid.

Technical details

This app supports three different methods to take screenshots

Legacy/Original method Legacy method switch on

This method uses the screen recording/screen cast capabilities of Android to record a single frame.

Requirements:

Properties:

  • Custom storage location
  • Custom format
  • Custom notification
  • Before Android 9 the ScreenCaptureIntent/MediaProjection permission was only asked once when adding the tile (with option "Don't show again"). Since Android 9 it needs to be granted frequently before taking a screenshot

Native method with system defaults enabled Native method switch on

This method uses the screenshot function of the device. It's exactly the same as pressing the Home+Power button or whichever key combination is used for screenshots on that phone.

Requirements:

  • Android 9 Pie
  • Accessibility service needs to be started in the system settings
  • Accessibility service screenshot

Properties:

  • No permissions needed, only activating the accessibility service once
  • Functions like long screenshots, screenshot editor, notifications, thumbnail etc., which the device manufacturer may have added, can be used

Native method with custom settings Native method switch on Use system defaults switch off

This method uses AccessibilityService#takeScreenshot which outputs a bitmap that can be compressed and stored on disk.

Requirements:

  • Android 11 R
  • Accessibility service needs to be started in the system settings
  • Storage permission
  • Accessibility service screenshot
  • Storage permission screenshot

Properties:

  • Custom storage location
  • Custom format
  • Custom notification

Restricted Settings

On Android 13 and above, device manufacturers may restrict the settings that can be enabled for an app. In such cases, the option to enable the app in the accessibility settings will appear grayed out. This means that both the "floating button" and the "native method" cannot be enabled. Notably, this is the case on Pixel phones running Android 14:

Grayed Out Accessibility Settings

To circumvent this protection, you need to enable the "restricted settings" option. First, try to enable the accessibility service. Tap on the grayed-out option, and you will see a dialog regarding the restricted settings:

Dialog About Restricted Settings

Now, open the Android system settings and go to "Apps" > "All apps." Find "ScreenshotTile," and in the app info, tap the three dots in the top right corner, and select "Allow Restricted Settings":

Allow Restricted Settings

With "restricted settings" allowed, you can reopen the app and enable either the "native method" or the "floating button." The accessibility settings will open, and you can enable the app.

Read more about this: https://support.google.com/android/answer/12623953#allowrestrictedsettings

Cast icon: cast icon (only Legacy method)

If you don't want to see the cast icon in the status bar on every screenshot, you can turn it off on most phones. I do not recommend turning it off, as it is generally a good idea to know when an app is recording the screen.
Here's an explanation on how to turn it off: PCTattletale.com - How to turn off Android's Pesky Chromecast Icon

Permissions

android.permission.WRITE_EXTERNAL_STORAGE "Photos/Media/Files and Storage"

Read the contents of your internal storage/USB storage
Modify or delete the contents of your internal storage/USB storage

This is required to save the screenshot files on the internal storage of your device. Since Android 10/Q this permission is no longer used.

Since Android 9/Pie this permission is required to take screenshots. It basically means that this app can run without showing itself. However the app will always show a notification when it is running.

Since Android 14/U this permission is required to take screenshots. It is a more specific version of the android.permission.FOREGROUND_SERVICE permission that allows to mirror the screen.

ScreenshotTile will start capturing everything that's displayed on your screen.

This is a special permission that is requested before you take a screenshot or when you add the tile to you quick settings. It allows the app to record the screen. In this case, for a screenshot, the recording is only one image/frame.

Since Android 13/Tiramisu this permission can be used to request the ability to show notifications. You can choose "Don't allow" to block all notifications.

You can automate taking screenshots with apps like MacroDroid or Tasker. This works via Broadcast intents.

Tutorial video on youtube: https://youtu.be/q5hQF1nzOzk

Macro intent screenshot

First you have to activate this feature by setting a password in the app settings.

Now you can add a macro to MacroDroid:

  • Open MacroDroid and tap on Macros and then Add Macro or the βž• Symbol
  • Tab βž• on Triggers and add your desired trigger
  • Tab βž• on Actions and go to Connectivity -> Send Intent
  • Under Target select Broadcast and fill out the fields:
    • Action: com.github.cvzi.screenshottile.SCREENSHOT
    • Package: com.github.cvzi.screenshottile
    • Data (class name): com.github.cvzi.screenshottile.IntentHandler
    • Extra 1 parameter: secret
    • Extra 1 value: yourPasswordFromEarlier
    • (Optional: Extra 2 parameter partial, value true to open the area selector for a partial screenshot instead of taking a screenshot)

Macro intent screenshot

You can also take screenshots from the terminal:

# Take a screenshot
am broadcast -a com.github.cvzi.screenshottile.SCREENSHOT -e secret MY_PASSWORD com.github.cvzi.screenshottile
# Open the area selector for a partial screenshot
am broadcast -a com.github.cvzi.screenshottile.SCREENSHOT -e secret MY_PASSWORD --ez partial true com.github.cvzi.screenshottile

Or via adb from a computer:

adb shell am broadcast -a com.github.cvzi.screenshottile.SCREENSHOT -e secret MY_PASSWORD com.github.cvzi.screenshottile

Miscellaneous data

Some miscellaneous files (mostly images) that don't need to be in the main repository of ScreenshotTile were moved to a separate repository: https://github.com/cvzi/ScreenshotTile_miscellaneous