Android.EweSticker

EweSticker is an Android sticker keyboard application, specifically designed for sharing a wide variety of custom stickers in supported messaging apps. This project draws inspiration from the uSticker project and is a fork of the woosticker repository.

• Features
• Dark Theme
• Light Theme
• Documentation
• Installation
• Application compatibility
  • Working
  • Known Issues/ Workarounds
• Gradle tasks
• Kotlin and Android Version
• Building From Source
  • Git Clone
    • Using The Command Line
    • Using GitHub Desktop
  • (or) Download Zip File
  • Download Android Studio
• Community Files
  • Licence
  • Changelog
  • Code of Conduct
  • Contributing
  • Security
  • Support
  • Development Info

Features

The EweSticker Android app offers the following key features to enhance your messaging experience:

• Wide Range of Custom Stickers Supported: EweSticker supports a diverse set of sticker formats, ensuring that users can share their creativity in various ways. Supported formats include image/gif, image/png, image/webp, image/jpeg, image/heif, video/3gpp, video/mp4, video/x-matroska, and video/webm.

• Seamless Sticker Sharing: Easily send stickers within messaging apps that support custom media sharing using image/png as a fallback.

• Customizable Scrolling: Use either vertical or horizontal scrolling to navigate through your sticker collection.

• Display Options: adjust the number of rows and the sticker preview size, tailoring the viewing experience to your liking and device screen dimensions.

• Search your Sticker library: Use a qwerty keyboard to search stickers by file name to ease discovery

• Integration with System Theme: EweSticker seamlessly integrates with the system's theme, ensuring that the app's appearance aligns with your device-wide design choices.

• Sticker Preview on Long Press: To facilitate sticker selection, you can long-press on a sticker to reveal a preview to help you quickly decide which sticker to share without the need to open the sticker collection separately.

EweSticker brings a wide range of customization options, diverse format support, and integration with messaging apps. Whether users are sharing static images, animated GIFs, or even short videos, the app aims to provide an engaging and expressive way to communicate using custom stickers.

Dark Theme

Light Theme

Documentation

A high-level overview of how the documentation is organized organized will help you know where to look for certain things:

• Tutorials take you by the hand through a series of steps to get started using the software. Start here if you’re new.
• The Technical Reference documents APIs and other aspects of the machinery. This documentation describes how to use the classes and functions at a lower level and assume that you have a good high-level understanding of the software.
• The Help guide provides a starting point and outlines common issues that you may have.

Installation

You can install the app using the following methods, Follow the link to the listing on your preferred store by clicking on one of the badges below, then download/install:

Application compatibility

Working

I've tested EweSticker with the various apps I have installed. Please note that it will likely be compatible with other applications as well.

app	id	webp	animated
Android Messages	com.google.android.apps.messaging	✔	✔
WhatsApp	com.whatsapp	✔	✖
Telegram	org.telegram.messenger	✔	✖
Signal	org.thoughtcrime.securesms	✔	✖
Discord	com.discord	✔	✔
Fair Email	eu.faircode.email	✔	✔
Element	im.vector.app	✔	✔
Moshidon	org.joinmastodon.android.moshinda	✔	✔
Google Keep	com.google.android.keep	✔	✖
Twitter	com.twitter.android	✔	✖

Known Issues/ Workarounds

app	id	Workaround
WeChat	com.tencent.mm	[Unknown]
Notion	notion.id	Displays the share sheet, can upload to a new note
Gmail	com.google.android.gm	Displays the share sheet, added to a new email
Reddit	com.reddit.frontpage	Displays the share sheet, added to a new post
Google Docs	com.google.android.apps.docs.editors.docs	Displays the share sheet, cannot add to google docs :(

Build from Source

Follow the steps in the Building from Source section.

Gradle tasks

• ktlintCheck (gradlew ktlintCheck): run ktlint over the codebase
• genDocs (gradlew genDocs): generate the api reference using dokka

Kotlin and Android Version

This app has been written in Kotlin 1.9.0 with the Android Studio IDE.

• The target SDK version is 34 (Android 14)
• The minimum SDK version is 26 (Android 8 Oreo)

Building From Source

1. Download or clone this GitHub repository
2. (If downloaded) Extract the zip archive
3. In Android Studio click File > Open and then navigate to the project file (Android studio defaults to the directory of the last opened file)

Git Clone

Using The Command Line

1. Press the Clone or download button in the top right

2. Copy the URL (link)

3. Open the command line and change directory to where you wish to clone to

4. Type 'git clone' followed by URL in step 2

   git clone https://github.com/FredHappyface/Android.EweSticker
   

More information can be found at https://help.github.com/en/articles/cloning-a-repository

Using GitHub Desktop

1. Press the Clone or download button in the top right
2. Click open in desktop
3. Choose the path for where you want and click Clone

More information can be found at https://help.github.com/en/desktop/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop

(or) Download Zip File

1. Download this GitHub repository
2. Extract the zip archive
3. Copy/ move to the desired location

Download Android Studio

Download the Android Studio IDE from https://developer.android.com/studio/. For Windows, double click the downloaded .exe file and follow the instructions provided by the installer - it will download the Android emulator and the Android SDK. Additional information can be found at https://developer.android.com/studio/install

Community Files

Licence

MIT License (See the LICENSE for more information.)

Changelog

See the Changelog for more information.

Code of Conduct

Our project welcomes individuals from diverse backgrounds and perspectives. We are committed to providing a friendly, safe and welcoming environment for all. Please see the Code of Conduct for more information.

Contributing

Your contributions are valuable and help improve the project for everyone, please see the Contributing Guidelines for more information.

Security

If you discover a security vulnerability, we appreciate your responsible disclosure. Please see the Security Policy for more information.

Support

Thank you for using this project, I hope it is of use to you. Please keep in mind that the folks working on this project are enthusiasts with various commitments such as work, family, and other passions. See the Support Policy for more information.

Development Info

Serves as a guide to various aspects of project development, including versioning, style guidelines, and recommended practices. Please see Development Info for more information.