aware_narrator/changes.txt at main · awareframework/aware_narrator · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
Todo:
- Add screentext pipeline to Aware Narrator project and update its README.md

2025-07-15
- Update config.yaml
    - Added merge_distance_threshold to set up threshold to merge home candidates during clustering.
    - Added input method to system_ui_apps:
        -  com.google.android.inputmethod.latin         # Gboard
- Updated aware_narrator
    - Clean up code
        - Remove count variable for app usage processing to keep only revisit_count
        - Update comments related to home merge threshold
    - Loading merge_distance_threshold from config.yaml.
    - Fallback to simple app sequences based on foreground app records when session data is avaliable but emtpy app sequence.
    - Update location clustering labels
        - Different unknown places are assigned to unique labels (e.g., unknown1, unknown2)


2025-07-14
- Updated aware_narrator
    - Improved system UI and blacklist filtering based on package name
    - Fixed system UI filtering bugs
    - Implemented centralied System UI filtering for application sensors: foreground, notification, and installation
    - Implemented System UI filtering for screentext sensors
    - Keyboard sensor does not apply system UI filering to avoid data loss (e.g., keyboard apps)


2025-07-10
- Manual setup:
    - Check updates on the github repo https://github.com/googlemaps/google-maps-services-python.git
    - Replace your local geocoding.py by finding the path
        -E.g.,  /home/ubuntu/miniforge3/envs/student/lib/python3.13/site-packages/googlemaps/geocoding.py by the latest script from the repo
    - https://github.com/googlemaps/google-maps-services-python/blob/master/googlemaps/geocoding.py
- Updated aware_narrator.py
    - Location:
        - Includec days without nighttime points
        - Implement address descriptors
        - Better readability
        - Filter out a visited place with 2 thresholds
            - Minimum data points:
                - Loaded from location_minimum_data_points in config.yaml
                    - E.g., at least 3 points to display a place in location description
            - Minimum stay duration:
                - Loaded from location_minimum_stay_minutes in config.yaml
                    - E.g., at least to stay 5 minutes to display a place in location description
        - Merged visit count, perioud, and sequence after fitering.
    - Bluetooth and WIFI
        - To show up to 10 most frequency detected named devices

- Added screen text preprocess pipeline
- Added geocoding.py for manual setup

- Updated README.md and config.yaml

2025-07-09
- Updated aware_narrator.py
    - Location: clean up redundant code; allows skip when no location data avaliable.
    - Implemented daily splitation
    - Support mulitple participants
    - Make sure using utf-8 when reading and writing to handle emojis
    - Update notification description to display text properly
    - Update keyboard description to more human-readable.
    - Updated reverse geocoding saved file name to include start date.

- Update README.md

- Updated config.yaml

2025-07-07
- Added aware_narrator.py, extract_sessions.py, split_description, json2jsonl.py, map_pid_deviceid.py
- Updated config.yaml
- Added environment configuration files: environment.yml and requirements.txt