1
0
mirror of https://github.com/chylex/Discord-History-Tracker.git synced 2024-12-04 21:42:47 +01:00
Desktop app & browser script that saves Discord chat history into a file, and an offline viewer that displays the file. https://dht.chylex.com
Go to file
2023-12-24 17:48:14 +01:00
.github Create FUNDING.yml 2020-05-13 23:25:00 +02:00
.idea Fix PyCharm project 2021-03-28 14:43:07 +02:00
.vscode Add VS Code tasks & copy tracker to clipboard after build 2018-08-05 10:59:13 +02:00
bld Release v.31f 2023-11-20 09:41:52 +01:00
lib Update UglifyJS & remove YUI Compressor 2021-06-13 17:20:11 +02:00
src Fix not storing channel topic and position if the channel is in a category 2023-12-24 17:48:14 +01:00
tools Add Python script to download attachments and image embeds & update the archive 2020-09-24 02:31:08 +02:00
web Split browser-only version into a separate branch 2022-03-20 16:50:00 +01:00
.gitattributes Enforce LF line endings 2020-09-23 19:42:57 +02:00
.gitignore Allow built tracker script & viewer in gitignore 2019-09-11 09:10:36 +02:00
build.py Refactor to match code from the app version (PR ) 2023-11-23 20:48:14 +01:00
LICENSE.md Rename LICENSE to LICENSE.md 2016-10-27 18:10:40 +02:00
README.md Split browser-only version into a separate branch 2022-03-20 16:50:00 +01:00

Welcome

This branch is dedicated to the browser-only version of Discord History Tracker. All you need to use it is either an up-to-date browser, or the Discord desktop client. Visit the official website for instructions.

To report an issue or suggestion, first please see the issues page and make sure someone else hasn't already created a similar issue report. If you do find an existing issue, comment on it or add a reaction. Otherwise, either click New Issue, or contact me via email contact@chylex.com or Twitter @chylexmc.

If you are interested in building from source code, continue reading the build instructions below.

Build Instructions

Setup

Fork the repository and clone it to your computer (if you've never used git, you can download the GitHub Desktop client to get started quickly).

By default, cloning will default to the master branch which is dedicated to the desktop app. Make sure to switch to the master-browser-only branch.

Now you can modify the source code:

  • src/tracker/ contains JS files that are automatically combined into the tracker bookmark/script
  • src/viewer/ contains HTML, CSS, JS files that are then combined into the offline viewer page
  • lib/ contains utilities required to build the project
  • web/ contains source code of the official website, which can be used as a template when making your own website

Building

After you've done changes to the source code, you will need to build it. Before that, download and install:

Now open the folder that contains build.py in a command line, and run python build.py to create a build with default settings. The following files will be created:

  • bld/track.js is the raw tracker script that can be pasted into a browser console
  • bld/track.html is the tracker script but sanitized for inclusion in HTML (see web/index.php for examples)
  • bld/viewer.html is the complete offline viewer

You can tweak the build process using the following flags:

Minification

The build process automatically minifies JS using UglifyJS@3, and CSS using a custom minifier.

  • If the --nominify flag is used, minification will be completely disabled
  • If uglify-js is not available from the command line, JS minification will be skipped
    • When building on Windows 64-bit, the build script will use the included Node runner and packages
    • When building on Windows 32-bit, you will need to download Node 32-bit and replace the included one in lib/
    • When building on Linux/Mac, the build script will attempt to find uglifyjs in the command line