Should change lables
Registration -> register
Dramatization -> dramatize

We need a way (or perhaps several ways?) to order the templates … preferably in order of number low to high on the folder name in the Template Directory. Another way would be according to what is done, pending, and not begun.
related to #124

Description of your problem

Ability to have more versatility in modifying and localizing a story, be able to delete the template pictures and insert a photo (of a real life scene or of a local drawing).
What steps will reproduce the problem?

What is the expected output? What do you see instead?
In the Draft phase (or Dramatize phase), somewhere on the corner of the picture, put icons (camera? X? +?) that when tapped, give the user the options to delete the picture or replace the picture with a photo .

Please provide any additional information below
This would be similar to replacing the background on the title slide.

Versions of the software and Android

• StoryProducer Version: 1.5
• Android SDK Version:

By early 2018, Bloom (HTML) will become the template creator for SP app. So the app needs to learn how to speak the Bloom HTML code as well as the XML code (which might gradually become redundant) Consult with @andrew-polk on this.

Perhaps relabel the resolution numbers as Low (320x240) - Mid (640x480) - High (1280x720) or something more intuitive. Even “resolution” could be relabeled to something like “video quality/size/res”. Possibly icons could be used as well.

Description of your problem

When translating from the draft texts, the user will sometimes need more explanation of a key word or phrase (e.g. Lord, temple, disciple, priest, Sea of Galilee) in order to meaningfully and accurately render it in their language. It is a bit clumsy/awkward to include explanations in brackets in the text. Textual notes in brackets also makes for menial work to put in the explanation every time the key word appears. And consistency issues arise with this method. It would be better if we had one key terms info document that a term in the story texts could link to. If the user needed more information on a term, they could tap the word and the info on that term would appear in a pop-up window. Tap the window's X and the user is back to the draft text screen.
The hyperlinks are also accessible in the text in the Consultant Check phase.
What steps will reproduce the problem?

What is the expected output? What do you see instead?

Please provide any additional information below
related to #51

Versions of the software and Android

• StoryProducer Version: 1.7
• Android SDK Version:

Relabel the File formats as 3gp for small screen / square screen / feature phone; mp4 for smartphone / big screen /rectangle screen Or maybe have a picture of a feature phone to tap and a smartphone rather than the text.

Here is the dump:

E/AndroidRuntime: FATAL EXCEPTION: main
    Process: org.sil.storyproducer, PID: 3214  
    java.lang.NullPointerException  
        at org.sil.storyproducer.tools.media.AudioPlayer.setVolume(AudioPlayer.java:160)  
        at   org.sil.storyproducer.controller.learn.LearnActivity$4.onCheckedChanged(LearnActivity.java:344)  
        at android.widget.CompoundButton.setChecked (CompoundButton.java:127)
        at android.widget.Switch.setChecked(Switch.java:666)
        at android.widget.CompoundButton.toggle(CompoundButton.java:87)
        at android.widget.CompoundButton.performClick(CompoundButton.java:99)
        at android.view.View$PerformClick.run(View.java:18599)
        at android.os.Handler.handleCallback(Handler.java:733)
        at android.os.Handler.dispatchMessage(Handler.java:95)
        at android.os.Looper.loop(Looper.java:157)
        at android.app.ActivityThread.main(ActivityThread.java:5883)
        at java.lang.reflect.Method.invokeNative(Native Method)
        at java.lang.reflect.Method.invoke(Method.java:515)
        at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:872)
        at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:688)
        at dalvik.system.NativeStart.main(Native Method)

We need to have the option to add audio of a local hymn at the end of the story along with the option of a local photo while the hymn is playing.

Be able to select a sound track to play in the back and have it play along. Here a are a few thoughts:

• It may need to be selectable per image
• Some audio processing to merge between audio tracks
• Possible some compression to not overdo the speakers
  • What does Faith Comes By Hearing do? Can we talk to their sound engineers?

Include Text and Include pan/zoom (Ken Burns) effects should be mutually exclusive options. If one is checked, the other should not be allowed.

• Add a location to gather licenses for hymns/photos
• Add a location to type (or record) contributors for acknowledgment
• save in project.xml?
• Append as 1 or 2 slides at the end of the video?
  ideas for UI here: https://docs.google.com/presentation/d/1F5enVGpQBg3Z0_5EwIPhVcuJkyL2ojKFbxjSNBcqjIk/edit?usp=sharing

We need an automated archival function of any created and shared videos.

• As soon as a video is created and filed (or have a specific action, such as view video->was it good?->archive it!), it automatically gets sent to the outbox by email to the archiving contacts in the Registration.
• When there is connectivity, the video is sent/uploaded automatically.
• Note: the automated naming would be helpful for meaningful archives.

Description of your problem

In the Draft phase when users research a key term (from the key terms info sheet activated by tapping a linked word in the text), it would be helpful for them to have a systematic way to record (via audio and/or text) their decision for rendering that key term in their language. Then, when they come across that key term again (perhaps in another story), they can be reminded of how they rendered it previously and be consistent
What steps will reproduce the problem?

What is the expected output? What do you see instead?
Perhaps, when a hyperlinked key term is tapped and the popup window appears with textual explanation for that term, in that window (maybe at the top) there could be a mic/record button for the user to record in his/her language the rendering for that term. When a recording has been done, a replay triangle button becomes available for play back. It would probably be good to keep a list of all the renderings recorded (like the comments in the community check) which can also be deleted. and renamed by press and hold.
Greenlighting: parallel to the column of recorded renderings, would be a column of recorded or text/typed back translations for each rendering. Or, maybe the user should be encouraged to give a literal word for word back translation in the LWC after saying the local language rendering in the same recording. Each recording for that key term would be automatically named in the LWC (the actual term + #).
These key term links and associated audio recordings are also accessible from the LWC text in the Consultant phase.

Please provide any additional information below
related to #50

Versions of the software and Android

• StoryProducer Version: 1.5
• Android SDK Version:

Make file writing (specifically recording and video creation) write first to temp files then move to a permanent location.
This may make it more stable but would also add complexity.

For easier distribution

The dark brown phase border could perhaps be a lighter shade of brown (tan?) so that the black icon shows up better. Or make it a different, lighter color, maybe purple or lavender.

At the top/front of the Registration page, maybe we need to add a permissions checkbox and statement indicating that, from the end-users, it is ok to get their contacts and that the info will not be used for commercial gain but only for team communication and archiving ….

The icon for this phase should be reworked:

• Gender neutral
• Show team of bilingual people for when consultant does not know MT

Proposals:

1. Perhaps have a person silhouette with a graduation cap on in front of two others to show that some others need to be involved with the consultant in this check.

What is the best way to display fonts?

• Increase text size to be more readable?
• Increase text size to the largest that can be on one page?
• Have it be larger and then scroll?
  • The way to scroll without flipping the phase is to press and hold on the text to scroll it rather than flipping the screen.

Use android.support.design.widget.FloatingActionButton and get rid of two dependencies in gradle.

Under Options, could there also be Include Audio Narration? (If Audio Narration is not checked, but Text is checked, then the video can be a reading book.) This may also be better to export as a gif or possibly a pdf.

Perhaps the Title should not have the LWC folder name as the default. Or perhaps putting a MT text title in the video should be in the Dramatization phase along with localizing the title slide.

We need to add a way to localize the title slide by inserting a local photo (or insert a picture from the story) to replace the empty gray background slide that is there.
Using stock android sharing capabilities Insert picture into title slide
RR: also enable better texting on top of the title slide image (light color text with dark color background and vice versa)

All audio files are saved as .wav files which have no compression. By saving in a high quality mp3 file, 80%+ of the space can be saved.

More of an issue for older/slow phones. Because of the delay in response, two phase changes may pile up.

If the recording bar stays visible once a recording has been made, perhaps there should be a warning if the mic icon is tapped that the first recording will be deleted, or the user could be given a choice to delete or not, so that the recording is somehow protected.

A need for consistent, readable understandable controls that are applicable to the stage:

• Observation: When recording, there is only a stop button, but actually, tapping the stop pauses the recording, then the record-append icon appears.
• Solution 1: Do away with the append-record icon and just have a pause button appear while recording along with a stop button. If the pause it tapped, an append-record icon appears. When the square stop icon is tapped, that ends the recording. I think we should do away with the double-tick icon as it currently functions as a stop-record.
  • should this be used just for dramatization or for everything?
• Icons: The play and stop icons on the image (for the MT translation) are a bit unintuitive. Make the square stop icon to be a pause icon since that is the actual function.

Include Ken Burns Effects could be relabelled to be Include Picture Movement or Pan Zoom Effects or something more intuitive (maybe a lot of people don’t know Ken Burns…)

The text should be enough for some translations.

Could the Export phases be split into two separate phases: Create Video & Share [or Publish and Distribute]. Having these in the same phase is a bit confusing/clunky and the Export UI gets hidden behind the Video Sharing label. It’s a bit confusing to have a Video Creation label at the top and also a ‘create video’ button at the bottom.

At the moment, the story template name comes from the Title cell in the story script (.doc). It might be more helpful if it could come from the name of the folder housing the template files.

1. Create an optional logo for sensitive situations -- replace the cross in the logo with a book/Bible silhouette, open or closed, with a typical Bible ribbon ?
2. Alternatively, have the main logo be suitable for sensitive situations

It would be nice to have some sort of progress indicator on the template screen for each story.
related to #21

I would think that we would want people to listen to the dramatization of each slide before a video is created. If yes, then we should enforce that.

Description of your problem

The app crashes

What steps will reproduce the problem?

1. skip registration
2. go back to registration
3. skip registration again
   Crash!

Versions of the software and Android

• StoryProducer Version: V1.2
• Android SDK Version: nougat

Currently, our code uses lots of indirect color literals (e.g. @color/gray) for backgrounds, text colors, and such. We really ought to use some scheme of foreground/background colors, or primary/secondary, etc. Then, our backgrounds can be @color/background, and we can change all of the backgrounds in the app in one change rather than having to change all of the literals.

From the hamburger icon, maybe the “menu” should be relabelled as “Story Templates” because that is where it opens to.

Description of your problem

v1.2 has the story slides numbered, beginning with the title slide, from 1 to whatever. However, the Word scripts have the numbering, beginning with the title slide, from 0 to whatever. These need to be consistent to enable less confusing remote consulting where the remote consultant might be using the Word scripts.
What steps will reproduce the problem?

What is the expected output? What do you see instead?
Page/Slide numbers in the UI will begin with the title slide as number zero (0)

Please provide any additional information below

Versions of the software and Android

• StoryProducer Version: 1.3
• Android SDK Version:

Suggestion: replace the clipboard icon on the phase identity bar with a hamburger icon to the far left, so that it is consistent with all the other screen.

To ask a few questions:

• Where are we in the progress of recording everything?
• Did we listen to the recordings yet?
• was all feedback listened to?

Description of your problem

When a video is made, there are often a few jumps in the video.

How can we make it less jumpy? What is the root cause? Can we make it not jumpy even on an underpowered phone?

Versions of the software and Android

• StoryProducer Version: V1.2

When a video is being shared or uploaded somewhere, maybe there should be a waiting/uploading icon or circle or bar to indicate when the upload or sharing is finished.

Description of your problem:

We'd like the ability to further adapt or modify the slide-show video template by being able to reorder slides to fit with the story telling style of the end-user. E.g. the template has a general story structure that looks like (1) introduce characters + (2) actions that introduce a problem + (3) climactic resolution of problem + (4) summarize story lesson. But maybe the receptor language has a general story structure that looks more like (4) + (1) + (2) + (3)

What steps will reproduce the problem?

What is the expected output? What do you see instead?
Perhaps the UI would have a sliding "bar" where all the pictures of a story in tiny format can be seen in a sliding line. If you press to select a picture and move it to another location then release it, it would move that slide (plus it's corresponding script text and audio narration) to a new location in the story.

Please provide any additional information below
Would slide/page numbers change or remain the same when relocated?

Versions of the software and Android

• StoryProducer Version: 1.7
• Android SDK Version:

Here a are a few thoughts:

• Can we remove the browse button altogether?
  • The saving location should default to the Movies folder.
  • Is the user expected to type anything into this field? If not, let’s remove the line.
• Replace browse with save/save as
• Maybe it should be Save As with a line after it and “short video name (key words)” on the line to prompt the user to type in a short language name for the video.
  • auto-generated name: ###_ShortLangFileName_Language_Country_LWCKeyWord.mp4
    • The initial 3 digit number of the file should come from the Template file #
    • The ShortLangFileName should come from what the user types in the Save As line
    • The Language would come from the Registration information, or maybe just put the 3 letter Ethnologue language code
    • The Country would come from the Registration info.
    • The LWC Key Word(s) would also come from the Template file name (i.e. Creation or Babel or Leopard)
  • The reason for having this file naming smart and automated is because:
    1. when a video is shared to archives, the file name will have helpful information right in it for proper archiving
    2. when a video is shared within the community, it will arrange itself in chronological/numerical order with the other videos for the viewer. Otherwise, the videos will be chaotically scattered all over the place on their phone.

When Include Text is checked, the app would be smart if it automatically only allowed the highest resolution video. The low and mid resolution formats are not good enough for the text to be stable on the screen. Language text in a video does not come out clearly with the low or mid resolution.

When all the slides have a recording, then make the black double-tick icon appear on the recording bar. This will require and remind end-users to listen to the dramatized story through from beginning to end -- and check off each slide as it is ok -- and only when all slides have been checked or double-ticked, allow them to go to Export phase.

Installation of the Templates with the app is a bit complicated. * Find the Templates wherever they may be.

• Instructions for requesting a url for templates
• Autodownload templates
• At least one public sample Template

With a description and installation instructions.

Description of your problem

The "X" is not removed when it should be

What steps will reproduce the problem?
Consultant approval -> Dramatize -> Record Draft for first time -> X still shows in Dramatize (although can be clicked and played properly)

Versions of the software and Android

• StoryProducer Version: 1.2
• Android SDK Version: Nougat