Skip to content

Latest commit

 

History

History
197 lines (132 loc) · 12.7 KB

README.md

File metadata and controls

197 lines (132 loc) · 12.7 KB
Raw

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.

android.permission.FOREGROUND_SERVICE

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.

android.permission.FOREGROUND_SERVICE_MEDIA_PROJECTION

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.

ScreenCaptureIntent

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.

android.permission.POST_NOTIFICATIONS

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.

Automatic screenshots with Broadcast intents

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

Automatic screenshots from terminal

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