Icon packs #509

alexbakker · 2020-07-05T16:31:38Z

We've recently been thinking some more about how to improve icon support in Aegis. Lots of users have been using krisu5's icon
pack as a source for icons in Aegis. The icon pack is great, but it's a bit of a pain for users to use, and that's Aegis' fault. To make the experience better, we want to introduce support for icon packs.

The idea is that creators of icon packs format their releases in the standard way described in this proposal, so that Aegis can read and use them.

This way, we can keep the maintenance of icons packs and Aegis itself separate, while also offering users the ability to use/create icon packs without being forced to use the one provided by the app.

@krisu5 We'd appreciate your feedback on this.

The format

Icon packs are .ZIP archives with a collection of icons and a pack.json file. The icon pack definition is a JSON file, formatted like the example below. All icon packs have a name, a UUID, a version and a list of icons. The version number is incremented when a new version of the icon pack is released. The UUID is randomly generated once and stays the same across different versions.

{
    "uuid": "e77dbfb5-30d6-468d-bf74-37f07734bcf5",
    "name": "Kristian's Icon Pack",
    "version": 1,
    "icons": [
        {
            "filename": "services/Google.png",
            "category": "Services",
            "issuer": [ "google" ]
        },
        {
            "filename": "services/Blizzard.png",
            "category": "Gaming",
            "issuer": [ "blizzard", "battle.net" ]
        }
    ]
}

Every icon definition contains the filename of the icon file, relative to the root of the .ZIP archive. Icon definitions also have a list of strings that the Issuer field in Aegis is matched against for automatic selection of an icon for new entries. Matching is done in a case-insensitve manner. There's also a category field.

The following image formats are supported, in order of preference:

Name	MIME	Extension
SVG	image/svg+xml	.svg
PNG	image/png	.png
JPEG	image/jpeg	.jpg

Any files in the .ZIP archive that are not the pack.json file or referred to in the icons list are ignored. Such files are not extracted when importing the icon pack into Aegis.

Changes to Aegis' vault format

Supporting multiple image formats also means that we have to make a small change to Aegis' vault format. Aegis currently only stores and expects JPEG images. We'd have to introduce a new icon_mime field for entries to store the MIME type of the icon. When loading older vaults, entries that do not have that field will try to parse the icon as JPEG.

I previously proposed moving icons out of the vault file entirely in #134, but that would be a much larger change, and has stalled improvements to our icon support. We can revisit if that's still desirable later.

We may also have to increment the vault format version, because previous versions of Aegis will no longer be able to load vaults with these changes.

Using icon packs in Aegis

Users can download an icon pack from the internet and import it into Aegis through the settings menu. Aegis extracts the icon pack to icons/{uuid}/{version}, relative to its internal storage directory. So for the example icon pack above, that'd be:
icons/e77dbfb5-30d6-468d-bf74-37f07734bcf5/1.0. If it has an old version of the icon pack, it will be removed after successful extraction of the newer version.

After that, Aegis will start proposing icons for new entries if the issuer matches with one of the icons in the pack. We'll also have an icon selection dialog, where all of the icons in the pack appear. When the user selects an icon, it is copied and stored in the vault file.

The text was updated successfully, but these errors were encountered:

krisu5 · 2020-07-05T18:10:44Z

All of this sounds great to me, this is pretty good compromise.

What happens if there's multiple icons for same service, like variation and alternative icons? My suggestion is to show all the icons that match issuer at the top of icon selection list, then show the rest.

Also if possible, maybe also have category value for cataloging the icons.

Here's some ugly mockups (not in Android design standard at all, but you get gist of it).

* (alphanumerical order)

alexbakker · 2020-07-06T19:33:38Z

Categories are a good idea! I've added a field for it to the specification. We may not make use of that field right away, to keep the initial version of the icon selection view simple, but we'll make it more complete as we go. I like your mockups, they're clean and simple.

What happens if there's multiple icons for same service, like variation and alternative icons? My suggestion is to show all the icons that match issuer at the top of icon selection list, then show the rest.

Yeah, that's probably a good way to handle that.

LeBaux · 2020-07-19T18:04:38Z

This is one of the features found in https://github.com/andOTP/andOTP I miss. Since there are thousands of services and websites, please start with the most notorious, such as most popular social media, GitHub/lab and such.

krisu5 · 2020-07-19T19:11:07Z

This is one of the features found in https://github.com/andOTP/andOTP I miss. Since there are thousands of services and websites, please start with the most notorious, such as most popular social media, GitHub/lab and such.

Icons aren't internally integrated like andOTP with this proposal. This just makes using icon packs like mine for example easier to use. My icon pack has covered most of the popular services (that has 2FA support) and has almost 260 icons.

Also weakness of andOTP system is the waiting time: you need to wait new app version every time you request a icon. With this current / new system, you can enable the new icon as soon as the icon files (SVG, PNG) is released.

alexbakker · 2020-07-27T19:25:52Z

I've submitted a draft PR that adds support for icon packs: #539. There's still work to do (on the design, especially), so this will not make it into a release of the app as is. Most of the functionality should already work, so I'm submitting this now so that people can start testing their icons packs.

@krisu5 If you'd like, you can start doing some preparation and testing to create your releases in the agreed icon pack format. I added a gen-icon-pack command to aegis-tools, perhaps that could be of use to get you started: https://github.com/alexbakker/aegis-tools/blob/91a36670c81436b83c049b4dd77b222e927e1a94/aegis_tools/__init__.py#L28-L58

krisu5 · 2020-08-27T09:34:52Z

@krisu5 If you'd like, you can start doing some preparation and testing to create your releases in the agreed icon pack format. I added a gen-icon-pack command to aegis-tools, perhaps that could be of use to get you started: https://github.com/alexbakker/aegis-tools/blob/91a36670c81436b83c049b4dd77b222e927e1a94/aegis_tools/__init__.py#L28-L58

Sorry for late response, I tried this script last month and today and same problem happens: it doesn't scan folder where script is launched. Maybe I'm missing something?

...\aegis-icons\SVG> aegis-tools gen-icon-pack --output test.zip
[Errno 2] No such file or directory: 'C:\\Users\\Kristian\\AppData\\Roaming\\Python\\Python38\\site-packages\\aegis\\simple-icons\\icons\\allocinã©.svg'
[Errno 2] No such file or directory: 'C:\\Users\\Kristian\\AppData\\Roaming\\Python\\Python38\\site-packages\\aegis\\simple-icons\\icons\\citroã«n.svg'
[Errno 2] No such file or directory: 'C:\\Users\\Kristian\\AppData\\Roaming\\Python\\Python38\\site-packages\\aegis\\simple-icons\\icons\\dassaultsystã¨mes.svg'
[Errno 2] No such file or directory: 'C:\\Users\\Kristian\\AppData\\Roaming\\Python\\Python38\\site-packages\\aegis\\simple-icons\\icons\\letâ€™sencrypt.svg'
[Errno 2] No such file or directory: 'C:\\Users\\Kristian\\AppData\\Roaming\\Python\\Python38\\site-packages\\aegis\\simple-icons\\icons\\macyâ€™s.svg'
[Errno 2] No such file or directory: "C:\\Users\\Kristian\\AppData\\Roaming\\Python\\Python38\\site-packages\\aegis\\simple-icons\\icons\\mcdonald's.svg"
[Errno 2] No such file or directory: 'C:\\Users\\Kristian\\AppData\\Roaming\\Python\\Python38\\site-packages\\aegis\\simple-icons\\icons\\metrodelaciudaddemã©xico.svg'
[Errno 2] No such file or directory: 'C:\\Users\\Kristian\\AppData\\Roaming\\Python\\Python38\\site-packages\\aegis\\simple-icons\\icons\\mã©trodeparis.svg'
[Errno 2] No such file or directory: 'C:\\Users\\Kristian\\AppData\\Roaming\\Python\\Python38\\site-packages\\aegis\\simple-icons\\icons\\micro:bit.svg'
[Errno 2] No such file or directory: 'C:\\Users\\Kristian\\AppData\\Roaming\\Python\\Python38\\site-packages\\aegis\\simple-icons\\icons\\pokã©mon.svg'
[Errno 2] No such file or directory: 'C:\\Users\\Kristian\\AppData\\Roaming\\Python\\Python38\\site-packages\\aegis\\simple-icons\\icons\\rtã‰.svg'
[Errno 2] No such file or directory: 'C:\\Users\\Kristian\\AppData\\Roaming\\Python\\Python38\\site-packages\\aegis\\simple-icons\\icons\\å\xa0koda.svg'

alexbakker · 2020-08-30T12:29:59Z

@krisu5 No worries! Yeah, that script just generates an Aegis icon pack based on simple-icons. As I don't know how you want to organize things, I just meant that it could serve as a starting point for you to write a script for your icon repository. Let me know if you need help.

eloyesp · 2020-11-05T19:39:31Z

While icon-packs sounds great for most popular sites, it does not solve the issue for less popular sites. I think that if you are already adding support for mime-types, another good option is making it easy to use favicons that are supported almost everywhere.

The most simple interface for this, is using just any web page and download the favicon there.

Does it makes sense?

krisu5 · 2020-11-05T23:24:05Z

I think that if you are already adding support for mime-types, another good option is making it easy to use favicons that are supported almost everywhere.

Biggest problem with this is that app wouldn't be offline only anymore. The app is made for most paranoid privacy users in mind, so it doesn't have any online features because of that.

Second is favicons 90% of the cases are too small, often small as 16px by 16px. Yes there are different types of favicons and webapp icons whatnot, but at worse it's pixelized mess that nobody wants.

And if people want icon for less popular site, just ask (I'm admin of aegis-icons). I make the icons, sometimes as fast as one hour of leaving issue.

WingofaGriffin · 2020-11-21T17:39:24Z

I am curious if, given the upcoming support for SVG vector images, it might make sense to bundle in aegis-icons as a "default" option for people who don't want to upload zip files now that the file size of the icons will be for the most part negligible. I understand the concern of keeping the projects separate, but would this not be something a git submodule would be able to handle? It's a tough balance between ease of use for users who want a plug and play solution, and fine tuned control for power users. This would also eliminate the concern of needing to manually update your icon packs.

alexbakker · 2020-12-06T19:03:09Z

I am curious if, given the upcoming support for SVG vector images, it might make sense to bundle in aegis-icons as a "default" option for people who don't want to upload zip files now that the file size of the icons will be for the most part negligible.

Yeah, I think this is something we could consider doing.

alexbakker · 2020-12-06T19:12:43Z

I spent some more time working on icon pack support today. Here's a prebuilt APK of the latest version of #539: https://alexbakker.me/u/e0k365wut0.apk. And an icon pack to test with: https://alexbakker.me/u/y0j0945odm.zip (generated using aegis-tools). It contains 1472 icons, all from the simple-icons project, randomly put into a list of categories. You can import the icon pack through "Settings -> Manage icons packs". It's not very pretty yet, but I think most of the functionality (except for search) we want is there now.

@krisu5 Did you get a chance to write something to generate a pack for your icon project? If you need some help, let us know.

krisu5 · 2020-12-06T22:15:24Z

@krisu5 Did you get a chance to write something to generate a pack for your icon project? If you need some help, let us know.

TBH, I don't have coding skills to do a script. 😅 I can use command line tools, but not program them.

alexbakker · 2020-12-07T10:16:38Z

That's fine, I'll open a PR in your repo sometime this week with a simple base script and we can work it out from there.

krisu5 · 2020-12-07T11:34:06Z

Sure, thanks!

AbramTTP · 2020-12-14T07:00:59Z

Ah, I just saw this issue. I last contributed to Krisu's repo for simple icons months ago.

I have this app that you all can refer to. It is a subscription manager named "Subby" available on Google Play.

Apparently they pre-load a list of icons in the app and lets you choose as you add or edit an entry.

It has a request button that allows you to input the service name and link, and it will convert to an email automatically to the devs for sending.

The simplistic styles of icons the app uses is very similar to Krisu's set.

alexbakker · 2021-02-10T19:36:15Z

We spent some more time working on this today.

AbramTTP · 2021-02-12T13:11:31Z

I see the:

"@alexbakker alexbakker mentioned this issue 26 days ago
Automatically get the icon from the url by parsing the favicon #667 "

Just to clarify that, no, Subby do not fetch the icons online over the URL for favicons. It is just simply sending the links for developers to manually refer to the media page or the main page of the product and design their icons before the next app release.

AbramTTP · 2021-02-12T13:12:29Z

We spent some more time working on this today.

This looks good!

alexbakker · 2021-04-10T08:59:37Z

@krisu5 We've merged icon pack support and may create an alpha or beta release soon. Are you ready to attach Aegis-compatible ZIP files to your releases on GitHub?

krisu5 · 2021-04-10T11:34:37Z

@krisu5 We've merged icon pack support and may create an alpha or beta release soon. Are you ready to attach Aegis-compatible ZIP files to your releases on GitHub?

Yeah, I can make pack as pre-release after I have completed current requests.

krisu5 · 2021-04-10T19:58:20Z

Test version of the icon pack released: ~~https://github.com/aegis-icons/aegis-icons/releases/tag/2021-04-10~~ (this version is now removed, check latest release instead)

OFC, I'm not sure yet if this pack works with upcoming preview version.

alexbakker · 2021-04-14T11:55:25Z

We've released v2.0-beta1 with support for icon packs! Please let us know if you see any issues. You can use aegis-icons or aegis-simple-icons as icon packs to test with.

OFC, I'm not sure yet if this pack works with upcoming preview version.

It does!

rcdailey · 2021-05-04T16:05:06Z

I added the icon pack to the preview version of Aegis but it doesn't show the icons.

alexbakker · 2021-05-04T16:08:42Z

What does "it doesn't show the icons" mean, specifically? Does the dialog not show up when you tap the icon in the entry editing screen? And which icon pack did you import?

rcdailey · 2021-05-04T16:50:10Z

Doesn't show the icons means I literally don't see them in the list of 2fa codes. Is the entry editing screen the one that lets you add a new icon pack? If so, tapping it does nothing. I downloaded the above linked "aegis-icons" pack; specifically the latest release there. I also installed thel inked 2.0 beta. Went to settings, icon packs, clicked add, selected the ZIP file for the icon pack. It shows up in the list of icon packs. Went back to the main screen, no icons.

alexbakker · 2021-05-04T16:53:16Z

Importing an icon pack does not automatically set icons on your existing entries. Long press on an entry in the main screen and tap the Edit icon in the menu that appears at the top. You're now in the entry editing screen. Tap the icon. Does it show the icon selection dialog?

krisu5 · 2021-05-04T16:59:57Z

You need to manually add them, it doesn't detect and automatically add the icons to 2FA entries.

After adding the icon pack, do steps 2 & 3 of this guide.

EDIT: Alex seems to be quicker then me, but if you need visual guide, see the link.

rcdailey · 2021-05-04T17:04:34Z

Yes it seems to work if I do it manually. But really I have to do it one by one? I have like 30 of these.

I think there needs to be a batch option. For example, a button to select all entries and another button to "reset" their icons to the icon pack.

EDIT: And thank you for the help.

krisu5 · 2021-05-04T17:09:52Z

Yes it seems to work if I do it manually. But really I have to do it one by one? I have like 30 of these.

I think there needs to be a batch option. For example, a button to select all entries and another button to "reset" their icons to the icon pack.

Currently, yes. Not sure if this changes in the future (not dev), but I think one possible reason for not doing automatically is that there's some icons that have multiple versions (background variation for black / AMOLED theme, black logo color variation for icons that has bright background and alternative logo icons).

alexbakker · 2021-05-04T19:49:48Z

But really I have to do it one by one? I have like 30 of these

Yeah, if you already have a bunch of entries, assigning icons is bit inconvenient currently. Perhaps we'll add a bulk option in the future. Like @krisu5 said though, due to the fact that users may have multiple icons packs (and multiple icon variants inside those), Aegis would not always be able to guess the exact desired icon.

rcdailey · 2021-05-04T19:57:25Z

Personally I'm fine with it batch-setting 30 for me, getting a handful wrong, and only fixing those. That's better than editing 30. Thanks for the response.

…

On Tue, May 4, 2021 at 2:50 PM Alexander Bakker ***@***.***> wrote: But really I have to do it one by one? I have like 30 of these Yeah, if you already have a bunch of entries, assigning icons is bit inconvenient currently. Perhaps we'll add a bulk option in the future. Like @krisu5 <https://github.com/krisu5> said though, due to the fact that users may have multiple icons packs (and multiple icon variants inside those), Aegis would not always be able to guess the exact desired icon. — You are receiving this because you commented. Reply to this email directly, view it on GitHub <#509 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AANPU5SFVK5XP3SAEQOZ6Z3TMBFXBANCNFSM4OQ6HORQ> .

krisu5 · 2021-05-24T18:20:08Z

Proper version of the icon pack released for Aegis 2.0, as it's coming out of beta soon.

https://github.com/aegis-icons/aegis-icons/releases/tag/2021-05-24

NumbGnat · 2021-05-26T21:16:33Z

But really I have to do it one by one? I have like 30 of these

...Perhaps we'll add a bulk option in the future. ...

I have many entries that are for the same servic. (i.e. gmail for myself, as well as other family members)

When the user selects multiple entries, the [edit] icon goes away. Perhaps enable edit, but only allow the icon to be changed. That would be a good compromise. I would think that might be fairly easy to implement... Just a variation of the edit screen for when multiple entries are selected.

Edit: The same edit screen could allow changing the Group of multiple entries too.

youdontneedtoknow22 · 2021-06-12T15:35:39Z

Are there any plans to integrate the icons in the app? At least the most popular ones. Google, Steam, Github, Facebook and so on. Most people downloading Aegis from the google play store (normal users who are told that Aegis is better than Google Authenticator because it's FOSS) won't go on github to see how to download the icons and add them manually.

alexbakker · 2021-06-12T15:43:54Z

@youdontneedtoknow22 Maybe, see: #509 (comment). No decision on that yet.

rcdailey · 2021-06-12T15:47:22Z

@alexbakker Any objections to me opening a new issue to track "automatic icon setting" separately so you can lock this one? I have a feeling people will continue to bump this issue requesting that. I think it's a separate discussion now that icon support is implemented. I think this thread has gotten too long and it's getting difficult to find information here.

krisu5 · 2021-06-12T16:14:14Z

Most people downloading Aegis from the google play store (normal users who are told that Aegis is better than Google Authenticator because it's FOSS) won't go on github to see how to download the icons and add them manually.

There's link to my icon pack in the "icon packs" setting page. Based of aegis-icons's view count, many have found the icons there (5x to 8x times more views then before).

Any objections to me opening a new issue to track "automatic icon setting" separately so you can lock this one? I have a feeling people will continue to bump this issue requesting that. I think it's a separate discussion now that icon support is implemented. I think this thread has gotten too long and it's getting difficult to find information here.

I think that would be the best, specially that this is closed for some time now.

rcdailey · 2021-06-12T16:55:04Z

I have opened user story #773 to track the automatic/batch icon assignment to existing entries. I respectfully ask anyone with further comment on this specific feature to do so over there.

Developers, please feel free to lock this issue to prevent further discussion and encourage those with meaningful contributions to visit the linked issue for further comment.

Thank you Aegis team for introducing this wonderful feature!

alexbakker added the proposal A proposal for a new feature label Jul 5, 2020

krisu5 mentioned this issue Jul 5, 2020

🎉 Good news! Inserting icons to Aegis will be easier at the future. aegis-icons/aegis-icons#93

Closed

alexbakker added the proposal-accepted An accepted proposal for a new feature label Jul 20, 2020

This was referenced Jul 22, 2020

Logo Library #409

Closed

Move icons out of the vault file to a separate folder #134

Closed

Transparency in image/icon displays as black. #249

Closed

Allow square/uncropped icons #216

Open

Add support for SVG icons #501

Closed

kongo09 mentioned this issue Oct 11, 2020

Provide easier icon support #598

Closed

alexbakker mentioned this issue Jan 17, 2021

Automatically get the icon from the url by parsing the favicon #667

Closed

alexbakker mentioned this issue Mar 5, 2021

Common Site Icons/Logos #703

Closed

alexbakker mentioned this issue Apr 7, 2021

Introduce support for icon packs #539

Merged

alexbakker closed this as completed in #539 Apr 10, 2021

rcdailey mentioned this issue Jun 12, 2021

Provide option to batch assign icons to existing 2FA entries #773

Closed

ukanuk mentioned this issue Oct 14, 2023

[Feature Request] SVG image/logo support CatimaLoyalty/Android#1142

Open

Icon packs #509

Icon packs #509

Comments

alexbakker commented Jul 5, 2020 • edited Loading

The format

Changes to Aegis' vault format

Using icon packs in Aegis

krisu5 commented Jul 5, 2020 • edited Loading

alexbakker commented Jul 6, 2020

LeBaux commented Jul 19, 2020

krisu5 commented Jul 19, 2020 • edited Loading

alexbakker commented Jul 27, 2020 • edited Loading

krisu5 commented Aug 27, 2020 • edited Loading

alexbakker commented Aug 30, 2020

eloyesp commented Nov 5, 2020

krisu5 commented Nov 5, 2020 • edited Loading

WingofaGriffin commented Nov 21, 2020 • edited Loading

alexbakker commented Dec 6, 2020 • edited Loading

alexbakker commented Dec 6, 2020

krisu5 commented Dec 6, 2020

alexbakker commented Dec 7, 2020

krisu5 commented Dec 7, 2020

AbramTTP commented Dec 14, 2020 • edited by alexbakker Loading

alexbakker commented Feb 10, 2021

AbramTTP commented Feb 12, 2021

AbramTTP commented Feb 12, 2021

alexbakker commented Apr 10, 2021 • edited Loading

krisu5 commented Apr 10, 2021

krisu5 commented Apr 10, 2021 • edited Loading

alexbakker commented Apr 14, 2021

rcdailey commented May 4, 2021

alexbakker commented May 4, 2021 • edited Loading

rcdailey commented May 4, 2021

alexbakker commented May 4, 2021

krisu5 commented May 4, 2021 • edited Loading

rcdailey commented May 4, 2021 • edited Loading

krisu5 commented May 4, 2021 • edited Loading

alexbakker commented May 4, 2021

rcdailey commented May 4, 2021 via email

krisu5 commented May 24, 2021 • edited Loading

NumbGnat commented May 26, 2021 • edited Loading

youdontneedtoknow22 commented Jun 12, 2021

alexbakker commented Jun 12, 2021

rcdailey commented Jun 12, 2021

krisu5 commented Jun 12, 2021 • edited Loading

rcdailey commented Jun 12, 2021

alexbakker commented Jul 5, 2020 •

edited

Loading

krisu5 commented Jul 5, 2020 •

edited

Loading

krisu5 commented Jul 19, 2020 •

edited

Loading

alexbakker commented Jul 27, 2020 •

edited

Loading

krisu5 commented Aug 27, 2020 •

edited

Loading

krisu5 commented Nov 5, 2020 •

edited

Loading

WingofaGriffin commented Nov 21, 2020 •

edited

Loading

alexbakker commented Dec 6, 2020 •

edited

Loading

AbramTTP commented Dec 14, 2020 •

edited by alexbakker

Loading

alexbakker commented Apr 10, 2021 •

edited

Loading

krisu5 commented Apr 10, 2021 •

edited

Loading

alexbakker commented May 4, 2021 •

edited

Loading

krisu5 commented May 4, 2021 •

edited

Loading

rcdailey commented May 4, 2021 •

edited

Loading

krisu5 commented May 4, 2021 •

edited

Loading

krisu5 commented May 24, 2021 •

edited

Loading

NumbGnat commented May 26, 2021 •

edited

Loading

krisu5 commented Jun 12, 2021 •

edited

Loading