Minor edits.

mark.george / timekeeper

Browse code Minor edits. master
1 parent 5f0d751 commit f4cc80e81917d57ad5c1d582ae6860bce914d744 Mark George authored on 13 Sep 2019

Patch

Showing 4 changed files

Ignore Space Show notes View README.md
# Description I got sick of giving lectures in rooms with a clock that is either non-functional or several minutes fast/slow. What happened to all the old militant academics who would throw tantrams at the building supervisors if there was a bad clock in a room? I don't wear a watch, but always have my phone with me since I use it for recording the lecture. So, I figured an app should do the trick. My requirements: * A simple fullscreen display with only a minute countdown, progress indicator, and correct time. * High-contrast white on black always-on display so I can see things with a dimmed screen. * Time-oriented since I want to be able to pick the end time rather than a duration. * Some kind of obvious indication when time is up. A quick survey of the app store showed that most apps in this category: * Were butt fugly. * Were ridden with ads. * Wanted more permissions than I was willing to give a timer app. * Were built for some specific purpose with mandatory breaks in the middle (WTH is pomodoro?). * Were in many cases not time-oriented. So, figuring that it has been a while since I tortured myself by writing an Android app, I built one that does what I need. # Downloading The APK is in the `app/build/outputs/apk/release` folder. Download and side load it. # Requirements Requires Android version 26 (Oreo) or better. # Usage 1. Run the app. 2. Enter your end time. If you bugger it up, tap reset. 3. Set the display update rate (defaults to 5 seconds). 4. Set the dim screen option (should use less battery with the screen dimmed). 5. Tap start. It will count down the minutes until the end time. The screen will stay awake for the entire time that the timer is visible. At 2 minutes out it will switch to minutes and seconds. At the end time the screen goes red, and it will start counting up so you know how much over time you are. To get out of the timer screen, swipe down from the top of the screen to get your navigation buttons back. I used 'sticky immersive' mode for the timer screen which will automatically hide the navigation buttons after a few seconds. This saved me from having to write my own fullscreen toggle, but does mean you have to swipe down from the top of the screen to get to the navigation bars which is a bit annoying (particularly if you don't know about it). # Description I got sick of giving lectures in rooms with a clock that is either non-functional or several minutes fast/slow. What happened to all the old militant academics who would throw tantrams at the building supervisors if there was a bad clock in a room? I don't wear a watch, but always have my phone with me since I use it for recording the lecture. So, I figured an app should do the trick. My requirements: * A simple fullscreen display with only a minute countdown, progress indicator, and correct time. * High-contrast white on black always-on display so I can see things with a dimmed screen. * Time-oriented since I want to be able to pick the end time rather than a duration. * Some kind of obvious indication when time is up. A quick survey of the app store showed that most apps in this category were: * Butt fugly. * Ridden with ads. * Built for some specific purpose with mandatory breaks in the middle (WTH is pomodoro?). * Most were not time-oriented. So, figuring that it has been a while since I tortured myself by writing an Android app, I built one that does what I need. FYI - Android development still sucks. Glad to see things have not changed since I last had to build an app a few years back. # Usage Run the app. Enter your end time. If you bugger it up, tap reset. Set the display update rate (defaults to 5 seconds). Set the dim screen option if you want it (should use less battery with the screen dimmed). Tap start. It will count down the minutes until the end time. At 2 minutes out it will switch to minutes and seconds. At the end time the screen goes red, and it will start counting up so you know how much over time you are. To get out of the timer screen, swipe down from the top to get your navigation buttons back. I got lazy and used 'sticky immersive' mode which will automatically hide the navigation buttons after a few seconds. This saved me from having to write my own fullscreen toggle, but does mean you have to use the swipe down to get to the navigation bars which is a bit annoying (particularly if you don't know about it).

Ignore Space Show notes View

README.md

# Description
I got sick of giving lectures in rooms with a clock that is either non-functional or several minutes fast/slow.  What happened to all the old militant academics who would throw tantrams at the building supervisors if there was a bad clock in a room?

I don't wear a watch, but always have my phone with me since I use it for recording the lecture. So, I figured an app should do the trick.

My requirements:
* A simple fullscreen display with only a minute countdown, progress indicator, and correct time.
* High-contrast white on black always-on display so I can see things with a dimmed screen.
* Time-oriented since I want to be able to pick the end time rather than a duration.
* Some kind of obvious indication when time is up.

A quick survey of the app store showed that most apps in this category:
* Were butt fugly.
* Were ridden with ads.
* Wanted more permissions than I was willing to give a timer app.
* Were built for some specific purpose with mandatory breaks in the middle (WTH is pomodoro?).
* Were in many cases not time-oriented.

So, figuring that it has been a while since I tortured myself by writing an Android app, I built one that does what I need.

# Downloading

The APK is in the `app/build/outputs/apk/release` folder.  Download and side load it.

# Requirements

Requires Android version 26 (Oreo) or better.

# Usage
1. Run the app.
2. Enter your end time.  If you bugger it up, tap reset.
3. Set the display update rate (defaults to 5 seconds).
4. Set the dim screen option (should use less battery with the screen dimmed).
5. Tap start.

It will count down the minutes until the end time.  The screen will stay awake for the entire time that the timer is visible.  At 2 minutes out it will switch to minutes and seconds.  At the end time the screen goes red, and it will start counting up so you know how much over time you are.

To get out of the timer screen, swipe down from the top of the screen to get your navigation buttons back.  I used 'sticky immersive' mode for the timer screen which will automatically hide the navigation buttons after a few seconds.  This saved me from having to write my own fullscreen toggle, but does mean you have to swipe down from the top of the screen to get to the navigation bars which is a bit annoying (particularly if you don't know about it).

I don't wear a watch, but always have my phone with me since I use it for recording the lecture. So, I figured an app should do the trick.

A quick survey of the app store showed that most apps in this category were:
* Butt fugly.
* Ridden with ads.
* Built for some specific purpose with mandatory breaks in the middle (WTH is pomodoro?).
* Most were not time-oriented.

So, figuring that it has been a while since I tortured myself by writing an Android app, I built one that does what I need.  FYI - Android development still sucks.  Glad to see things have not changed since I last had to build an app a few years back.

# Usage
Run the app.  Enter your end time.  If you bugger it up, tap reset. Set the display update rate (defaults to 5 seconds).  Set the dim screen option if you want it (should use less battery with the screen dimmed).  Tap start.

It will count down the minutes until the end time.  At 2 minutes out it will switch to minutes and seconds.  At the end time the screen goes red, and it will start counting up so you know how much over time you are.

To get out of the timer screen, swipe down from the top to get your navigation buttons back.  I got lazy and used 'sticky immersive' mode which will automatically hide the navigation buttons after a few seconds.  This saved me from having to write my own fullscreen toggle, but does mean you have to use the swipe down to get to the navigation bars which is a bit annoying (particularly if you don't know about it).

Show notes View app/build/outputs/apk/release/timekeeper.apk 100644 → 0
Not supported

Ignore Space Show notes View app/build/outputs/apk/release/timekeeper.apk 0 → 120000
app-release-unsigned.apk

Ignore Space Show notes View app/src/main/java/nz/ac/otago/infosci/timekeeper/SettingsActivity.java
package nz.ac.otago.infosci.timekeeper; import android.content.Intent; import android.os.Bundle; import android.view.View; import android.widget.Button; import android.widget.CheckBox; import android.widget.EditText; import android.widget.NumberPicker; import android.widget.TextView; import android.widget.TimePicker; import android.widget.Toast; import androidx.appcompat.app.AppCompatActivity; import androidx.appcompat.app.AppCompatDelegate; import java.time.LocalTime; public class SettingsActivity extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_settings); final Button btnStart = findViewById(R.id.btnStart); final Button btnReset = findViewById(R.id.btnReset); final TimePicker timePicker = findViewById(R.id.timePicker); final CheckBox cbDimScreen = findViewById(R.id.cbDimScreen); final NumberPicker periodPicker = findViewById(R.id.periodPicker); periodPicker.setMinValue(1); periodPicker.setMaxValue(30); periodPicker.setValue(5); cbDimScreen.setChecked(true); // 12 hour clock timePicker.setIs24HourView(false); btnReset.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View view) { // need to reset the clock, but so far the only way I have found to do this is recreate the entire activity... recreate(); } }); btnStart.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View view) { int endHour = timePicker.getHour(); int endMinutes = timePicker.getMinute(); int updatePeriod = periodPicker.getValue(); boolean dimScreen = cbDimScreen.isChecked(); LocalTime end = LocalTime.of(endHour, endMinutes); if (end.isBefore(LocalTime.now())) { Toast.makeText(SettingsActivity.this, "End time must be in the future", Toast.LENGTH_LONG).show(); return; } Intent it = new Intent(SettingsActivity.this, TimerActivity.class); it.putExtra("endHour", endHour); it.putExtra("endMinutes", endMinutes); it.putExtra("updatePeriod", updatePeriod); it.putExtra("dimScreen", dimScreen); SettingsActivity.this.startActivity(it); } }); // force dark theme AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_YES); } } package nz.ac.otago.infosci.timekeeper; import android.content.Intent; import android.os.Bundle; import android.view.View; import android.widget.Button; import android.widget.CheckBox; import android.widget.EditText; import android.widget.NumberPicker; import android.widget.TextView; import android.widget.TimePicker; import android.widget.Toast; import androidx.appcompat.app.AppCompatActivity; import androidx.appcompat.app.AppCompatDelegate; import java.time.LocalTime; public class SettingsActivity extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_settings); final Button btnStart = findViewById(R.id.btnStart); final Button btnReset = findViewById(R.id.btnReset); final TimePicker timePicker = findViewById(R.id.timePicker); final CheckBox cbDimScreen = findViewById(R.id.cbDimScreen); final NumberPicker periodPicker = findViewById(R.id.periodPicker); periodPicker.setMinValue(1); periodPicker.setMaxValue(30); periodPicker.setValue(5); // 12 hour clock timePicker.setIs24HourView(false); btnReset.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View view) { // need to reset the clock, but so far the only way I have found to do this is recreate the entire activity... recreate(); } }); btnStart.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View view) { int endHour = timePicker.getHour(); int endMinutes = timePicker.getMinute(); int updatePeriod = periodPicker.getValue(); boolean dimScreen = cbDimScreen.isChecked(); LocalTime end = LocalTime.of(endHour, endMinutes); if (end.isBefore(LocalTime.now())) { Toast.makeText(SettingsActivity.this, "End time must be in the future", Toast.LENGTH_LONG).show(); return; } Intent it = new Intent(SettingsActivity.this, TimerActivity.class); it.putExtra("endHour", endHour); it.putExtra("endMinutes", endMinutes); it.putExtra("updatePeriod", updatePeriod); it.putExtra("dimScreen", dimScreen); SettingsActivity.this.startActivity(it); } }); // force dark theme AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_YES); } }

Ignore Space Show notes View

app/src/main/java/nz/ac/otago/infosci/timekeeper/SettingsActivity.java

package nz.ac.otago.infosci.timekeeper;

import android.content.Intent;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.CheckBox;
import android.widget.EditText;
import android.widget.NumberPicker;
import android.widget.TextView;
import android.widget.TimePicker;
import android.widget.Toast;

import androidx.appcompat.app.AppCompatActivity;
import androidx.appcompat.app.AppCompatDelegate;

import java.time.LocalTime;

public class SettingsActivity extends AppCompatActivity {

@Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_settings);

final Button btnStart = findViewById(R.id.btnStart);
        final Button btnReset = findViewById(R.id.btnReset);
        final TimePicker timePicker = findViewById(R.id.timePicker);
        final CheckBox cbDimScreen = findViewById(R.id.cbDimScreen);

final NumberPicker periodPicker = findViewById(R.id.periodPicker);
        periodPicker.setMinValue(1);
        periodPicker.setMaxValue(30);
        periodPicker.setValue(5);
        cbDimScreen.setChecked(true);

// 12 hour clock
        timePicker.setIs24HourView(false);

btnReset.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                // need to reset the clock, but so far the only way I have found to do this is recreate the entire activity...
                recreate();
            }
        });

btnStart.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                int endHour = timePicker.getHour();
                int endMinutes = timePicker.getMinute();
                int updatePeriod = periodPicker.getValue();
                boolean dimScreen = cbDimScreen.isChecked();

LocalTime end = LocalTime.of(endHour, endMinutes);

if (end.isBefore(LocalTime.now())) {
                    Toast.makeText(SettingsActivity.this, "End time must be in the future", Toast.LENGTH_LONG).show();
                    return;
                }

Intent it = new Intent(SettingsActivity.this, TimerActivity.class);
                it.putExtra("endHour", endHour);
                it.putExtra("endMinutes", endMinutes);
                it.putExtra("updatePeriod", updatePeriod);
                it.putExtra("dimScreen", dimScreen);
                SettingsActivity.this.startActivity(it);
            }
        });

// force dark theme
        AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_YES);

}