jameshnsears/quoteunquote

A Quotes / Quotations / Affirmations App Widget.

Quote Unquote

---

1. Status

	ci	codecov	codacy	sonarcloud	codescene	deployment
:app	codecov.yml	codecov.yml
:cloudLib
functions
:utilsLib

1.1. codecov.yml

test	androidTest	cli (API 30)	codecov
		post-push-codecov.sh

---

2. High Level Design

2.1. Deployment Diagram

2.2. androidTest ROOM Class Diagram

---

3. Build Instructions

After cloning extract .gpg files - BuildConfig / GitHub Action Secrets values.

The app can be built on Windows 11 but the ./bin folder contains bash scripts (that work with git bash; some require gh cli).

3.1. CLI

git clone https://github.com/jameshnsears/QuoteUnquote
cd QuoteUnquote
git submodule update --init --recursive
git submodule foreach git pull origin main
git submodule

3.2. Android Studio

Android Studio > Get from Version Control
 > https://github.com/jameshnsears/QuoteUnquote
 > Clone

NOTE: import to clone for IDE as submodules maintained

VCS > Git > Branches...
 > Remote Branches > origin/main > Checkout
  > Smart Checkout

git submodule update --remote

git remote add origin/cloudLib https://github.com/jameshnsears/QuoteUnquote.cloudLib
git remote add origin/cloudLib.functions https://github.com/jameshnsears/QuoteUnquote.cloudLib.functions
git remote add origin/utilsLib https://github.com/jameshnsears/QuoteUnquote.utilsLib

Build > Rebuild Project

Choose a Build Variant  
 > run a Run/Debug Configuration

3.3. PyCharm

After a clone...

PyCharm > Open > QuoteUnquote.cloudLib.functions

File > Settings > Project:
 > set Intepreter > New Virtualenv Environment

Virtualenv Terminal > 
 > python -m pip install -r requirements-test.txt
 > python -m pip install -r src/requirements.txt

run a Run/Debug Configuration 
 > setting Python Intepreter to Virtualenv Environment

quoteunquote's Issues

edit quote data base

1 Many people want quotes for a specific subject or goal it would be nice if the quote data base could be edited so that it only held the quotes the user wanted and the user could add their own quotes

Maybe have a custom quotes added from a csv text file. Maybe have an option to only show the custom text file quotes

2 if there is a custom quote database it would be nice if there was on device backup. No everyone wants to put things in the cloud when a 5tb drive is under $100

[Question] Filter philosophers

Is there a proper way to filter out for only (for example): Greek, Japanese and Chinese philosophers?

If there's a proper way I'd like to know how and I thing it'd be a good addition as a guide for the future people that starts using the app :)

option to hide author

I'm 99 % interested in the quote then the author so it would be nice if showing the author name was optional. Maybe have a temporary unhide when i am temporary curious about the authors name.
Maybe custom font or size for author only might be interesting.

Black widget back ground

I could not find a dark widget background.
It would be nice if there was black, dark grey and dark versions of other colors. It a custom color picker.
I like dark colors because the use battery

"include the possibility to share your app in the quotes"

From: exitiumLupus [email protected]

Formatting issue

Version: 3.2.1-fdroid
Android: 11 (RQ3A.211001.001)

The regular format (Quote -> blank line -> Author -> blank line -> Count) is not adhered to whenever the widget displays quotes from 'Top Quotes'. As seen in the screenshot, the format changes to Quote -> Dash -> Author (on the same line) -> blank line -> Count.

Note: Setting is Configuration / Quotations / All. The above issue is encountered only when the app randomly picks quote from within 'Top Quotes'. No issue with other quotes.

Broken, reinstall is the only thing that fixes it

Version of the app
Version: [e.g. 2.4.0-fdroid]

Describe the bug
This is the 2nd time this has happened. Previously I was on an old version, I was hopeful updating would do the trick but looks like the bug still exists. I was just flipping through top quotes sequentially and then after passing about 1000/21794 the widget went blank. Rebooting doesn't fix it either. Below is some evidence which might help diagnose it.

Screenshots
https://drive.google.com/file/d/17RBHvQOZKhFNCNucsZw4tLZwcOOtY6HW/view?usp=drivesdk

At one point before I recorded the video it displayed a quote in my favorites widget without me ever clicking anything, and it showed "null" for the index. Clicking next at that point made it go blank again.

Is there the possibility to have a small thumbnail with some bio details of the quote's author?

From: exitiumLupus [email protected]

Exclude quotes from a given author(s)

Adding this feature would help people avoid seeing quotes from people, with whose philosophies they don't agree with or whose quotes have no value (I'm looking at you, Shakespeare).

It would work the same as the "All" selection, but would have a field that would accept text input and exclude any quotes, where there are strings that match any words found in the "author" field of the quotes.

For example entering "Shakespeare" would exclude a quote that has "Shakespeare, Hamlet (1600-1601)" in its author field.

[FR] more transition options

e.g. I'd like bi-hourly, maybe three-hourly changing of quotes.

Optional Source share

b6p5kzq3:

My only issue is with sharing a quote. I use the "/r/quote/top" as the source and I have the source disabled under appearances. This is great because I don't see "/r/quote/top" under the quotes on my home screen. Unfortunately the source shows up when I share the quote. Are you able to modify the sharing module so if the source is disabled, it does not show up?

Option "Next, random" advances sequentially daily

Version: 3.0.4 FDroid
Android 10
Lawnchair Launcher (version 1.2.1.2001 from FDroid)

I have set the option "next, random" under the "Notifictions" options, but it only goes up one quote sequentially each day.

I don't know if I'm misunderstanding the option, but I thought it would jump to a random quote each day.

Here is a screenshot of my options, if it helps.

Search function selection for Favourites

Search function has to be also put in for favourites so quote can be easily accessed from favourite quotes already selected by user

Create a Telegram Group

Just a thought, please consider adding a telegram group chat for users to ask questions and add improvements to the app. Might work better than email in the event you have to repeat the same response to multiple users. Also might be easier for average users who are not well versed in GitHub submission to add their idea.

Thanks!

Randomization

Version: 2.8.0-googleplay

Describe the bug
Not sure how long ago it was but sometime last year the randomize button stopped randomizing and instead behaves identical to the sequential button. I assumed til now that it was probably my local data's fault. I have uninstalled, verified that /data/data/com.github.jameshnsears.quoteunquote no longer exists in root storage, and reinstalled with no luck. Please advise if there is anything else I could try on my end. Cheers

Galaxy S21 Ultra (SM-G998U)

more cooler

appreciation
Wow.. this app is cream of the crop ... I really love it

so what!
Quyz... would ot be much cooler if you include the aready shown qouets ..that. is... when I have read a quotes from a specific specfic Author say .. Epictetus who has a collecton of 255.. I would want to wee the number added as read when I return back to view the all quotes section...
That is to mean if I was in no 100 in the all quotes/read section.. the new no.. should be 355 since I have already previewed the 255 from Epictetus..

thanks

Center quotes & source in same line

So quotes can be really long and short, so it would be nice to have the option to center the text, vertically and horizontally.
For me I would maybe do this as the default behavior.

Also it would also be nice then to have the option that the source is in the same line:
[Quote] - [Source]

How do I export or download all 20000+ quotes in this app?

Where do I do this? It would most likely be somewhere on GitHub.

Recycle when end reached

As subject.

Raised by two people!

Divide Quotation row, in App Widget, into two - the second being clickable

I have source disabled so is it possible to have the author's name be clickable for r/quotes/top?

via b6p5kzq3@...

You should add instruction

What's CSV file ?
Where can I download the CSV file for the quotes ?
How do I link the file to the widget ?
Is there a youtube video explaining how to do it ??

There are a lot of things on the widget that could mean literally anything. Have I spent the last 3 hours trying to figure this out

So on and so forth. The below average joe such as myself would find it difficult to understand how to do things. ( There is a reason why they have instructions. What is commonsense for some people may not be for others)
I learnt what CSV is by trying to figure out how to get the app widget to work (it still hasn't worked because Idk where to get the quotes from)

Option to source quotes directly from CSV instead of importing

Thanks for this excellent widget; it's been on my homescreen since I discovered it. However, there's a bit of a different way I'd like to use it. I'd like to use it to display the verse of the day on my homescreen.

I've made it about 95% of the way to that point (bash scripting), but there's a problem: QuoteUnquote doens't source its data from a CSV directly, but instead imports the quotes into its internal database.

I'd like to be able to run a bash script via cron to update votd.csv (replacing yesterday's file), which QuoteUnquote watches and updates automatically when a change is detected (or, more likely, on a schedule). The file will contain only one entry, in the format requested, but would be updated in place rather than imported.

Is there any way to do this as is with QuoteUnquote, or would it be necessary to add the ability to source (a) quote(s) directly from a file to accomplish this? Alternatively, could the import of a specified file be scheduled?

teenie bug

There is this bug where even after disabling every "toolbar" item i.e. share, previous, next, random etc… It takes up a lot of dead space (as you can see in the … It would be nice if there was more flexibility on the resizing)

p.s I am not sure if this is a limitation/fault of my launcher, android widgets or your awesome app.

Help is appreciated, thank you!

Drop ", toggle" from Notification; Exclude Source from Notification switch

b6p5kzq3@...

Also, is it possible to add an option to remove the source from notifications? I have /r/quotes/top enabled and would prefer not to see that in the notification. Perhaps tie it to the widget source toggle. If it's off for the widget, it is also off for the notifications.

Also, I don't think the word toggle is necessary next to favorite in the notification.

No shortcut created

I installed this app but there is no shortcut to launch it. It is listed in the Android apps list.
Using Android 9 with Color OS6 on Oppo Realme RMX1805

Backup Option, Author's Name, Notification Only.

Thanks for the wonderful app.

1. I use custom ROM and change my OS from time to time which requires me to reinstall all apps including 'Quote Unquote'.
   I want to backup the app settings and the current state (eg. track the quotes that have already been displayed, so that they are not repeated with the next install ). I know there is a feature to sync between devices, but that would not work in my case.

2. While sharing the quote, I want the app to include the author's name.

3. Under Schedule / Display, add 'Notification Only' option.

If you need any information or clarity, let me know.

Ethiopia biblical quotations

Emanuel Kebede [email protected]

Hi my brother. My name is Amanuel kebede from Ethiopia. I love your app "quote unquote". I wanted to use it just by changing the verses inside it. I wanted to use bible verses as quotations. And i have prepared the database for it followimg your database format. I attached the database to this email. I tried many times to use apk editor to replace the quotations database but i was unable. I don't have deep coding knowledge but a love for it and fhe word of god. Can you please replace the quotations database in the asset folder then compile and send it to me?

God bless you.

Rounded widget edges

The sharp corners of the background look a little jarring, maybe add an option to round them?

Updated ru (Russian) translation

I have translated your application into ru (Russian). Here is the xml:
https://hastebin.com/tetotiquho

---

Translation made with Stringlate.

Add text outline / shadow / glow

Currently using the widget without any background cuz I don't like the colors available, but the white text clashes with the brighter colors on my wallpaper.

Is it possible to let the user select an outline or a glow effect for the text, and select ita color separately? That would allow users to customize it more, for example white glow for dark text, black glow (shadow) for white text and pink glow for quote gurus 😄 etc.

Blank widget, jump to current not working

Version: 4.0.1-fdroid
Android: 11 (RQ3A.211001.001)

Apologies if the following is a little convoluted.

Today I updated the app from 4.0.0-fdroid to 4.0.1-fdroid without changing any settings. I am not sure if the problem started with version 4.0.0 or 4.0.1.

While fiddling with the back button (for previous quotes), I noticed that the widget turned blank (A) after showing the previous 5 quotes.

I had to press back button 10+ times to get another quote (B). The widget would then blank again and show the same quote (B) after a few tries - like a carousel.

When I pressed the 'Jump to current' button, the widget did not display the current one. I had to click the button multiple times for that feature to work.

Once back to the status quo (A), I pressed the forward button a few times (<10) hoping the previous 6 and current quote would show up in a cyclical order but they did not.

There was no change in the behaviour after rebooting the phone.

I thought maybe you removed some of the old quotes, so I cleared the app cache and restarted the phone once again.

I noticed that the current quote (181 - Neil Patrick Harris) was not the same as before (I don't remember the exact number but it was quote regarding heaven, hell and soul).

When I pressed the back button, it changed to 180,179,178,176 and stopped. Skipped 177. This time the 'Jumped to current' button worked. When I pressed forward button from 176, it skipped 177 and then went to 178 and so on.

I know version 4.0.2-fdroid is on the way but I don't think it has a fix for this problem.

I have two JSON files which I am unable to share here. One taken today with version 4.0.1-fdroid (uKainymXa4) and another one using version 3.2.1-fdroid ((filename suffixed with _1)) while filing issue #31 on 6th September 2022. The widget was then showing quote 165, so there is no way I would reach quote 181 within 4 days.

I have uploaded the latest JSON to Google Cloud. Hope that helps.

tap widget to change quote

It would be nice if you could just tap the widget to change the quote. Get rid of the tool bar all together and tap the widget to do things. Have a setting for options like advanced next or advanced random. Maybe even double tap for favorite or other options.
Or maybe tap left side for advance random right side for next and middle for favorite.

Make color of toolbar buttons the same as text color

The buttons being black, when the text is white makes no sense at all, they should be the same for consistency's sake. Or even make a separate color selector for the buttons.

Automatic backup

I want backup (settings, favorites, past 'viewed quotes' history) to happen automatically (locally or cloud) at regular intervals (1,7,30 days).

Widget does not remain on home screen

Hi,
I installed the latest version for my Motorola phone Moto G5 S
Android version 8.1.0 .
The widget of quotation can be dragged on home screen but it does not
remain visible once the finger is lifted.

Can you please help.
Best,
Bharat
p.s. it's a wonderful app that you have made

Sent from my Android device with K-9 Mail. Please excuse my brevity.

App widget background to change depending upon theme

b6p5kzq3

Hello,

Is it possible to implement something to have the widget change based on system wide light or dark mode? Currently I have a white background with dark text and toolbar during the day but then at night I manually switch it to a black background and light text and toolbar. It would be great if you were able to implement something to do it automatically based on the system wide switch between light and dark mode.

Please let me know if this is feasible.

Thank you!

Select different font style for the author

A purely aesthetic consideration, but quotes are usually displayed in italic, with the authors in normal font, or vice versa, it would be nice to be able to mimic this style.
Just add a separate font option for the author text.

Ability to copy the quote as text to paste it somewhere else.

Love your app. I searched in the app for this feature but can't find it. I would like to copy the quote I like from the widget as text. Right now, I just take screenshots but they are not convenient.

The ideal scenerio would be the ability to copy the text from the app and paste it into my notes app for later access or paste it to word app to be printed. Now if this feature does exist, please point me in the right direction. Thanks again for the app.

Hide quote ennumerator

The little text saying which number the current quote is might be redundant for many people (me included). Having an option to turn it off might be nice.

example on csv file for import?

Is there an example of the csv file needed for importing custom quotes.
My old file no longer imports, want to check what is proper example

Create your own quote.

Sometimes i find quotes which relates to me and what i wannna be doing. So custom support where you can manually add quotes and display all custom created quotes. Thank you

random advance just goes to the last quote

On latest fdroid 306.
I picked one author che
Using the random advance just goes to the last quote of the author #17
Forward and back work fine but from where ever i am when i hit random advance it goes to#17 of che.
After i switched to a different author random now only advances forward one quote. I'll do some more testing and report back

View changelog

Hello,

Please add the ability to view changelog within the app.
If not the entire changelog, then at least for the last 3 iterations and a link to a single page on Github.

Thanks.

Break link between notification and widget content advancement

b6p5kzq3@...

Please add a separate option for just notifications for situations where the user does not wish to update the widget and just wants to receive notifications.

A way to export favorites?

Thanks for fun app, I enjoy browsing through quotes and this is app is apt for it 😄

I was wondering if there was a way to export favorites?

random advance should show any random quote

Right now when you have seen all the quotes random advance just shows the last quote. Random advance should advance to a random quote even previously seen ones.

There should also be an option for random advance in the "recurring events". IE: so that on a phone unlock a truly random quote is switched to.

toolbar joined widget

It would be nice if the small space between the tool bar and widget was gone as an option.

Add Text and button color option

It would be really nice to also set a color for text and the buttons.

I'm not sure if it makes sense to seperate it, but with a transparent effect on a dark background you can see nothing for example.

Thank you for this nice little app, keep going. 👍

Browse Quotes feature

b6p5kzq3@....

Are you able add a view option in the configuration screen to quickly let the user view the quotes? For example, I want to quickly see all the favorite quotes in one page instead of scrolling through it on the widget.

Implement Material You