WhatsApp stickerpack with Danganronpa characters.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
noirscape 0e5a2ddc0d
Added Celestia Ludenberg
7 months ago
app Added Celestia Ludenberg 7 months ago
gradle/wrapper Kyoko added 7 months ago
pngs Added Celestia Ludenberg 7 months ago
.gitignore [Android] change the Android folder to upper case. 9 months ago
README.md Cleanup 7 months ago
build.gradle Bump Android Gradle Plugin to 3.3.0 7 months ago
gradle.properties [Android] change the Android folder to upper case. 9 months ago
gradlew [Android] change the Android folder to upper case. 9 months ago
gradlew.bat [Android] change the Android folder to upper case. 9 months ago
settings.gradle [Android] change the Android folder to upper case. 9 months ago

README.md

Danganronpa Sticker Pack for WhatsApp

Included Characters

  • Kyoko Kirigiri

Danganronpa and similar are copyrighted to Spike Chunsoft.

Imagemagick commands

mkdir stickers
mogrify -gravity center -crop 512x512+0+0 +repage -path stickers *.png
convert -gravity center -background none -extent 96x96 filename.png
mogrify -path ../x -format webp *.png

Sticker art and app requirements

We recommend you refer to the FAQ at https://faq.whatsapp.com/general/26000226 for complete details on how to properly create your sticker art. This FAQ also contains a sample PSD that demonstrates best practices for composing legible, rich sticker art.

  • A sticker is an image that has a transparent background and can be sent in a WhatsApp chat
  • Stickers are organized into “packs”. Your app can contain anywhere from 1 to 10 packs. Users must explicitly add each pack to WhatsApp one-by-one, so your app should list each pack separately and each pack must have its own affordance to add it to WhatsApp (do not try to create “add all packs” operations).
  • Each sticker pack must have a minimum of 3 stickers and a maximum of 30 stickers
  • Stickers must be exactly 512 x 512 pixels
  • Stickers will render on a variety of backgrounds, white, black, colored, patterned, etc. Test your sticker art on a variety of backgrounds. For this reason, we recommend you add a 8px #FFFFFF stroke to the outside of each sticker. See the sample PSD referenced at https://faq.whatsapp.com/general/26000226 for more details.
  • Stickers must be in the WebP format. Currently, animated WebP or animated stickers are not supported. See the section Converting to WebP below for information on how to create WebP files.
  • Each sticker must be less than 100KB. See the section Tips for Reducing File Size below.
  • Sticker Picker/Tray Icon
    • Provide an image that will be used to represent your sticker pack in the WhatsApp sticker picker/tray
    • This image should be 96 x 96 pixels
    • Max file size of 50KB

Tips for reducing file size

We recommend reducing the size of each of your stickers. For reference, many of the stickers provided within WhatsApp are around 15KB each. The smaller your stickers, the faster they will send and the less data your users will have to spend sending them or downloading your app. Depending on your art and the type of graphics you’ve created, one of these two methods may result in smaller file sizes so we recommend experimenting with both.

  • The first method involves optimizing your PNGs using a PNG optimizer tool. If you’re on MacOS, use https://pngmini.com. We recommend using Median Cut and adjusting the colors bar to reduce the size. If you’re on Windows, use https://nukesaq88.github.io/Pngyu to optimize your PNGs. Then, convert them to WebP using the methods described in the Converting to WebP section.
  • The second method involves saving or converting your stickers as WebP while experimenting with the WebP export settings trying to optimize the images. You should try setting the quality of your WebP output to something lower than 100% and experiment with a quality level that gets you the smallest file size possible without noticeable image degradation. Each of the methods described in Converting to WebP for exporting your files to WebP offer ways to control your resolution.

Converting to WebP

Your sticker art must be in the WebP format. We recommend using the tools you’re most comfortable with to draw and compose your art, and converting them to WebP using one of a few different tools:

  • Sketch for Mac lets you export files as WebP. Open your sticker art file in Sketch, select a layer, multiple layers, or an artboard, and select Make Exportable in the bottom right. Pick your format as WebP, select Export, and then select the quality/resolution.
  • Android Studio allows you to convert PNGs to WebP. Simply create a new project in Android Studio, open your PNG and right click on the image and select convert to WebP (https://developer.android.com/studio/write/convert-webp). Make sure you uncheck the box next to “Skip images with transparency/alpha channel” in the export flow.
  • You can install a plugin for Photoshop that converts to WebP. Make sure to uncheck the “Save Metadata” checkbox. Some users have experienced problems with using the webp files generated from Photoshop. If you have problems, we suggest you create PNG files, and use Android Studio to do the conversion.
  • Use cwebp, a command line tool

Modifying the contents.json file

You must also modify the contents.json file in SampleStickerApp/app/src/main/assets. Replace the values of the metadata with your own. A few notes:

  • name: the sticker pack’s name (128 characters max)
  • identifier: The identifier should be unique and can be alphanumeric: a-z, A-Z, 0-9, and the following characters are also allowed “_“, “-”, “.” and “ “. The identifier should be less than 128 characters.
  • publisher: name of the publisher of the pack (128 characters max)
  • Replace the “image_file” value with the file name of your sticker image. It must have both the file name and extension. The ordering of the files in the JSON will dictate the ordering of your stickers in your pack.
  • android_play_store_link and ios_app_store_link (optional fields): here you can put the URL to your sticker app in the Google Play Store and Apple App Store (if you have an iOS version of your sticker app). If you provide these URLs, users who receive a sticker from your app in WhatsApp can tap on it to view your sticker app in the respective App Stores. On Android, the URL follows the format https://play.google.com/store/apps/details?id=com.example where “com.example” is your app’s package name.
  • emojis (optional): add up to a maximum of three emoji for each sticker file. Select emoji that best describe or represent that sticker file. For example, if the sticker is portraying love, you may choose to add a heart emoji like 💕. If your sticker portrays pizza, you may want to add the pizza slice emoji 🍕. In the future, WhatsApp will support a search function for stickers and tagging your sticker files with emoji will enable that. The sticker picker/tray in WhatsApp today already categorizes stickers into emotion categories (love, happy, sad, and angry) and it does this based on the emoji you tag your stickers with.

The following fields are optional: ios_app_store_link, android_app_store_link, publisher_website, privacy_policy_website, license_agreement_website, emoji

If your app has more than 1 sticker pack, you will need to reference it in contents.json. Simply create a second array within the “sticker_packs” section of the JSON and include all the metadata (name, identifier, etc) along with all the references to the sticker files.

Build the sample app

Before building your app, you will need to do the following:

  • Make sure to change the app’s icon (i.e. launcher icon) that will be displayed on the home screens of users who install your app. The icons are contained in SampleStickerApp/app/src/main/res in each of the folders beginning with mipmap (e.g. mipmap-xhdpi or mipmap-xxxhdpi). For a simple way to create these icons, you can use Android Image Asset Studio which is built into Android Studio. See https://developer.android.com/studio/write/image-asset-studio#access for more information on how to run this tool and read the section here for information on how to use the tool to create your app’s launcher icons.
  • Change your apps name in strings.xml (SampleStickerApp/app/src/main/res/values/strings.xml). This is the name users will see for your app on their phone.
  • In addition, the application id (e.g. com.whatsapp) need to be changed. Note that you need to specify a unique application id that does not exist in play store. For more information on how to set your application ID, visit https://developer.android.com/studio/build/application-id.
  • Change the applicationId in build.gradle (SampleStickerApp/app/build.gradle)
  • For developers that are familiar with package name, you can change the package name, but it is not required. The package name will not be visible once the app is built.

Make sure to run and test your sticker app. For help on building your app, visit https://developer.android.com/studio/run/. The app will run some checks. If there are problems, you will see the error in logcat. If there are no errors, the app will launch successfully displaying the sticker packs you have included.