RedditPlaceExplorer
A lightweight offline viewer for r/place written in java
Features:
- Offline dataset for 2017 and 2022 (about 700MiB compressed, 1GiB uncompressed, 20 GiB less than the original .csv files)
- Lossless compression (and much smaller than raw video files)
- Accurate simulation of the canvas as it was displayed originally
- Rewinding and backwards simulation of the canvas
- Fast and efficient seeking
- Dataset pre-caching/snapshotting for instantaneous skips in time
- No internet connection needed after initial download
Known Issues:
- Pixel simulation has a bug currently, some pixels are not being updated properly, a fix is on the way...
- Fix added for 2017 dataset (preprocessing error)
- Fix for 2022 unavailable until reddit publishes a fix for their .csv.
In short pixels that have the same timestamp might not be ordered correctly, resulting in slight divergences in the simulation compared to the actual canvas. - Upon further analysis it might also be some pixels missing in the dataset or pixels that are in the dataset but did not get updated to the canvas.
TODO: (in the future?)
- Synchronising the offcial reddit dataset with unofficial canvas snapshots can fix the problem, though the result won't be 100% accurate compared to the real event due to timing discrepancies.
- Explain how the dataset and caching works
- Add user hashes to the binary dataset
- Add find functionality in program for finding specific events
- Add other data such as heatmap
The x64 binaries download for windows with both 2017 and 2022 datasets is around 750MiB. After cache/snapshot generation the total program size grows to approximately 2.6GiB. The cache allows for instantaneous jumps and large seeks. To prevent the cache from generating, simply delete the /cache/ folder before running the program, but be aware that you will lose the ability to seek large timesteps without lag.
The download with .jar and dataset alone (without JRE) is around 640MiB.
When running the program for the first time the cache will be generated at launch. It might take one minute or more for older systems. On newer systems with SSDs it should only take a few seconds. This cache only needs to be generated once, subsequent launches will not generate cache. If the cache gets corrupted because of a power interruption, simply delete the files inside the /cache/ folder. Do not delete the folder itself if you still want to use the cache.
The program requires around of 200MB of RAM during my testing, and it should run fine on older systems.
Note that this was coded with my spare time during the Reddit 2022 r/place April Fools' event, so there might be unexpected bugs and the code is extremely messy.
Controls
T: toggle between 2017/2022 canvas
F1: toggle help menu
F2: toggle hud
F3: toggle seek bar
F11: toggle fullscreen
Mouse drag: move canvas
Right click: set cursor
Scroll wheel: zoom
Shift/Ctrl: x10/x100 multiplier
Q/E: backward/forward one iteration
A/D: time seek
Arrow keys: move canvas
F: set cursor to camera
Alt+F: remove cursor
Z/X or PgUp/PgDown: zoom in/out
R: reset canvas
C: reset camera
V: jump to cursor
0-9: load preset
Ctrl+0-9: save camera preset
Shift+0-9: save time preset
Alt+0-9: delete preset
Building
Simply download NetBeans and load the project.
Dataset Sources
2017 r/place Dataset .csv ~1GiB
2022 r/place Dataset .csv ~21GiB