The Digital Methods Initiative Twitter Capture and Analysis Toolset (DMI-TCAT) allows one to retrieve and collect tweets from Twitter and to analyze them in various ways.
You can find detailed installation instructions in the wiki
- Twitter API credentials (these can be obtained from https://apps.twitter.com)
- One of the following Linux distributions:
- Ubuntu 18.04
- Debian 9.*
- ... or Docker (experimental)
Debian and Ubuntu
curl https://raw.githubusercontent.com/digitalmethodsinitiative/dmi-tcat/master/helpers/tcat-install-linux.sh | sudo bash
Our latest Docker images are availble on Docker Hub.
- Install Docker Desktop, and start it. Note that on Windows, you may need to ensure that WSL (Windows Subsystem for Linux) integration is enabled in Docker. You can find this in the Docker setting in Settings -> Resources-> WSL Integration -> Enable integration with required distros.
- Run the command
docker run --publish 80:80 --volume tcat_data:/var/lib/mysql/ --detach --name tcat digitalmethodsinitiative/tcat:1.0and Docker will download version 1.0 (or whatever tag with which you replace the "1.0")
--publish HOST_PORT:80allows you to define which port on the host network is used. If you are using a different port, you may also need to add
-e SERVERNAME=localhost:HOST_PORTwhere HOST_PORT is the desired port as this is used for internal links in the TCAT interface.
--volume volume_name:/var/lib/mysql/ensures you are easily able to reuse your TCAT mysql database and recover data after you are no longer using TCAT
- Open the logs to retrieve you login information via either Docker's interface or the command line
docker logs tcat(installation may take some time, so you can either wait or run
docker logs -f tcatto follow along)
- Open http://localhost:80 in your browser and complete the configuration by providing your Twitter API information and which type of tweet capturing you would like to do.
- Congratulations! You can use the
adminmenu to create your first tweet capture bins
- In the future, you can stop and start your TCAT container with:
docker stop tcatand
docker start tcat
Customize for you own server
The Docker installation also allows you to easily host TCAT on a server. In addition to the
SERVERNAME environment variable, you can also use Let's Encrypt by adding
-e LETSENCRYPT=y and
-e LETSENCRYPT_EMAILfirstname.lastname@example.org. You should also open port 443 for Let's Encrypt to work. Your full command might look like this:
docker run --publish 80:80 --publish 443:443 --volume tcat_data:/var/lib/mysql/ --detach --name tcat -e SERVERNAME=my.website.com -e LETSENCRYPT=y -e LETSENCRYPT_EMAILemail@example.com digitalmethodsinitiative/tcat:1.0
Further TCAT customization
Finally, if you wish to develop TCAT yourself, you can clone this repository and create your own image.
- Clone this repository
git clone https://github.com/digitalmethodsinitiative/dmi-tcat.git
- Build the image (from the directory where you have cloned TCAT):
docker image build --progress=plain -t tcat:1.0 .
tcat:1.0from above in your
Please use the issue templates when reporting issues and bugs.
Nice way to describe the fact that we don't have much
We are happy to receive suggestions and improvements.
Apache License Version 2.0