Initial Picture tutorial enhancement for new users

[sibilek]

Research

Enter an [ x ] character to confirm the points below:

[ x ] I have read the support page and am reporting a bug or enhancement request specific to AnkiDroid

[ x ] I have checked the manual and the FAQ and could not find a solution to my issue

[ x ] I have searched for similar existing issues here and on the user forum

I have recommended Anki to many of my friends. Most of those people are not familiar with Anki and common reply I get from them "Okay! this is empty". So I thought it would be good if a initial tutorial, which will walk through new user in the app, appear for one time when installed for the first time. So I made some preparations with pictures. I really know these pics are so amateur. I hope you like it. I really want to contribute to AnkiDroid development. I am so curious about helping but I have lack of developing ability. right now it's a bit higher than my ability. but I will take a look to online courses. I hope I can learn.

1. Most of new users don't know about SRS. So I thought it will be good to give quick info.
2. Most of new users don't know about sync option.

BTW I made these pics with PicsArt https://play.google.com/store/apps/details?id=com.picsart.studio

[JaysonH91]

I think this would be very handy. I m new to anki & Android dev, but think this would be interesting to take up

[hssm]

If you are interested in working on it, have a look at something like AppIntro. There is a large list of applications that make use of the library that you can use for inspiration. I would encourage you to look at what other apps do and try to copy them.

[sibilek]

Thank you Jayson and Houssam. These pictures are my first thoughts. Like sketches. I hope and sure you will come up with more brilliant ideas. And I am looking forward to join coding and development process.

Have a nice day

Sinan Bilek 20 Haz 2016 23:24 tarihinde "Houssam Salem" notifications@github.com yazdı:

If you are interested in working on it, have a look at something like AppIntro https://github.com/PaoloRotolo/AppIntro. There is a large list of applications that make use of the library that you can use for inspiration. I would encourage you to look at what other apps do and try to copy them.

— You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub https://github.com/ankidroid/Anki-Android/issues/4334#issuecomment-227258427, or mute the thread https://github.com/notifications/unsubscribe/ALWC-OU3yrK2jP0h2FgZTZ5n6BTpAQEGks5qNvcXgaJpZM4I58pl .

[timrae]

:+1:

[Kartikkman]

@mikehardy @timrae

This issue seems very much interesting to me , Can I take this up please ( if it is not completed yet or anyone else is not working on this ) ?? Please put some of your views for this , How should I begin with this issue ??

Thank You @mikehardy @timrae

[Kartikkman]

@mikehardy , Any suggestions on this ??

[timrae]

Sure, please feel free to take it up! Following on from what has already been done here, and following up on hssm's recommendation mentioned in this thread would be a good way to get started

https://github.com/ankidroid/Anki-Android/issues/4334#issuecomment-227258427

[mikehardy]

Sorry - was traveling yesterday all day - just got back to work. Looks like Tim nailed it. Have fun :-)

[Kartikkman]

Thanks @timrae @mikehardy !!! I am now starting to work upon this , Will be posting updates & queries for this thing !!

-I am beginning with the Library ( will make another small app to test this on or what do you say ? ) -Start looking on the other apps implementation ( ones which I have in my mind as of now is nRF Connect , others you please suggest !!! )

[mikehardy]

I think that's a good idea - just to have the basic tutorial screens, they can be overlayed on any app (including what Android Studio would generate as a default starter app if you made a new project) so that's a great way to test it and using Android Studio you can do screen captures / video recordings too so you can easily youtube upload a screen capture showing the work

[Kartikkman]

Just wanted to ask , does Anki-Ankroid supports Android X ?? Has it been Migrated on to that ?? @mikehardy

[mikehardy]

I believe it is just 'Android 10' (not 'X' the roman numeral) https://en.wikipedia.org/wiki/Android_10

And while I have not tested it recently I don't see any reason it should not - there are some specific changes to how Android 10 handles the external storage permissions (with the introduction of scoped storage) but I believe AnkiDroid uses things correctly so it should not affect us? Maybe you could fire it up in an emulator and try to confirm?

https://developer.android.com/preview/privacy/scoped-storage

https://android-developers.googleblog.com/2019/04/android-q-scoped-storage-best-practices.html

"Enhancement: AnkiDroid should not use Storage permission" https://github.com/ankidroid/Anki-Android/issues/5304

[Kartikkman]

Hii @mikehardy ,

I am sorry for mis-understanding , By the above I meant this :

Written on AppIntro Github Page :

https://github.com/AppIntro/AppIntro

Add the dependency Please note that AppIntro supports Android X. If you haven't migrated yet, you probably want to use a previous version of the library that uses the old Support Library packages (or try Jetifier Reverse mode).

By AndroidX , I meant :

StackOverflow : https://stackoverflow.com/questions/51280090/what-is-androidx

AndroidX is a redesigned library to make package names more clear. So from now on android hierarchy will be for only android default classes, which comes with android operating system and other library/dependencies will be part of androidx (makes more sense). So from now on all the new development will be updated in androidx.

Again , So sorry for miscommunication !! @mikehardy

[mikehardy]

Ah haha - of course. I'm not used to seeing that one with a space. It's always AndroidX. And yes, AnkiDroid has converted to AndroidX - we're all good there, no dependency issues. https://github.com/ankidroid/Anki-Android/pull/4995

[Kartikkman]

@mikehardy

AppIntro_Ankidroid

I just tried , setting up library & using its minimalist features ( it works like a charm !! )

• I still need to use fragments with this ( first need to learn fragments though !!!!! :/ )
• Decide on What content to put on these App Intro Screens
• Need to Decide on Best Colors to fit for these
• Apply Shared Preferences for above ( so that it only runs when user logs into app first time and we can ( if you wish ) add Tutorial option on Navigation Drawer so user can watch tutorial an time ??

Well lots to decide on !! . Will be proceeding with first step , whats your say on this ?? @mikehardy

Thanks Kartikkman

[mikehardy]

sounds like the right direction

for colors I would stick to the existing theme colors (which you know after digging into the theme XML file for the navigation bar fix)

[Kartikkman]

Hey @mikehardy , Here is what I could do ( I believe that we can a wayyy lot better than this , but I just came with this as of now ) .

Video Link

I would be happy to rework on this . Please put your suggestions .

Thank You @mikehardy

[mikehardy]

I requested access for it because it's not public on google drive - could you make it completely public or maybe push it up to youtube? (just in case, so everyone can see it?) :+1:

[Kartikkman]

Hey @mikehardy , Just Gave Access , anyone with link can view .

Sorry for issue !!

[mikehardy]

I think it's a good start - I would love to see the ankiweb registration / search for deck / download deck / import deck part if you can take some screenshots of that and show them. Helping people get lots of free content immediately would answer most of the first-time questions we get where people have no idea where to start, then if you also showed them using it to sync, it would fix the other major category of questions we get: I lost my cards :-)

[Kartikkman]

Hi @mikehardy , Here is Video on search for deck / download deck / ankiweb registration / Sync Changes

Download Deck

Syncing Changes

Please Guide me on Next Steps !!

[mikehardy]

Well definitely only use fresh test accounts for posting videos of login and signup - for security reasons. I edited your comment to remove the link to the login video because that shows your gmail account and people can watch the password etc.

I like the videos but distributing video with the app will increase it's size.

If we were able to post these on youtube (like the introduction video we use for the Play Store listing) then use a webview in the tutorial with an iframe that embedded the youtube links like this example, then you could have a set of tutorial screens that had headers describing the main points "add a card", "download a shared deck", "create AnkiWeb account", "synchronize" and each could embed the related video?

You have an example app right now with tutorial screens I think? Could you see if you can put the webview with embedded youtube link in it (maybe just trying the video from the play store to start) and see if they all connect?

[Kartikkman]

Hey @mikehardy , Here is Progress Uptill Now : I played with WebView & iframe Tag to Play YouTube Video .

• It is easy to play Youtube Video in WebView ( User needs to click on play button )
• Not that Easy to Play Youtube Video on Auto Mode although We can do it , I tested that & its working
• we can only play video on Auto Mode with No sound
• To Play Video on Auto Mode ( with Sound ) , there are methods available on internet : Some Suggested Emulated Touch , Some using JavaScript to Play Video .

So my ques is :

• Should I stick to playing only " Youtube " Video on WebView or look for something else ( like playing from Google Drive) ?
• Following those unofficial methods , though these give some issues ( which I need to figure out )

Suggestions ? @mikehardy

[mikehardy]

I actually strongly prefer that videos do not autoplay, so having the user click to play is perfectly fine by me. Very cool if this will work.

I swear - if we could reduce the number of confused users that open the app and see no cards (because they are done reviewing and SRS doesn't show more cards), or then try to download a shared deck and get lost, or lose their collections because they don't sync...oh man, so many users so much happier!

[Kartikkman]

Ok @mikehardy

Then I am finalizing with the Video on WebView ( no Auto Mode ) . Although I was now just reading the YouTube API for Android ( so Leaving that for Now !! )

I will be then updating you with the results of ( Playing Youtbe Video on WebView ) inside Fragments ( although Read just Now that Iframe Tag inside Fragments is not so good ) .

So I do that & post results ! & Regarding Videos , Well I will try to improve them & include Video on above content suggested by you .

[mikehardy]

here is Anki's introductory video, for inspiration https://www.youtube.com/watch?v=QS2G-k2hQyg - shows how to grab a shared deck and import it (though for AnkiDroid it is a little different of course)

[timrae]

I'm a bit confused, I thought this issue was for making an in-app picture tutorial, but now you are talking about playing YouTube videos from a webview?

[Kartikkman]

Well @timrae , We can have Static Picture Tutorial , I thought that didn't gave too much explanation . So I thought maybe we should go for Videos .

If there needs to be Static Images then No issues I will go fro them . You please finalize

@mikehardy @timrae

[timrae]

I think static images would work best for an in-app tutorial. But I agree with you that video can provide more information, so we can just put a URL at the end of the tutorial to a YouTube video and the user manual, for those that want more information (and have internet access).

[Kartikkman]

Hey @timrae @mikehardy I have started creating Static Images as Decided . Here is one , Please share your views :

Create Decks Quiz Media Rich

[Kartikkman]

@mikehardy @timrae Waiting for Feedback

[github-actions[bot]]

Hello 👋, this issue has been opened for more than 2 months with no activity on it. If the issue is still here, please keep in mind that we need community support and help to fix it! Just comment something like still searching for solutions and if you found one, please open a pull request! You have 7 days until this gets closed automatically

[Arnold2381]

@david-allison-1 does this need work?

[mikehardy]

This is in progress as a GSoC project with all sorts of related activity.