Visual intel chat analysis, planning and notification application for EVE Online. Gathers status through in-game intelligence channels on all known hostiles and presents all the data on a dotlan generated regional map. The map is annotated in real-time as players report intel in monitored chat channels.
Vintel is written with Python 3.7, using PyQt5 for the application presentation layer, BeautifulSoup4 for SVG parsing, and Pyglet for audio playback.
The current release version of Vintel can be found here. Currently only Windows distributions are available for download with this release.
Keep up on the latest at the wiki or visit our issues page to see what bugs and features are in the queue.
- Platforms supported: Mac, Windows and Linux (currently only Windows is active).
- Systems on the map display different color backgrounds as their alarms age, with text indicating how long ago the specific system was reported. Background color becomes red when a system is reported and lightens (red->orange->yellow->white) in the following intervals: 4min, 10min, 15min, and 25min.
- Systems reported clear display on the map with a green background for 10 minutes.
- Clicking on a specific system will display all messages bound on that system. From there one can can set a system alarm, set the sytems clear or set it as the current system for one or more of your characters.
- Clicking on a system in the intel channel causes it to be highlighted on the map with a blue background for 10 seconds.
- The system where your character is currently located is highlighted on the map with an violet background automatically whenever a characater changes systems.
- Alarms can be set so that task-bar notifications are displayed when an intel report calls out a system within a specified number of jumps from your character(s). This can be configured from the task-bar icon.
- The main window can be set up to remain "always on top" and be displayed with a specified level of transparency.
- Ship names in the intel chat are marked green.
- Manually checking pilot(s) using an EVE client chat channel: Type xxx in any chat channel and drag and drop the pilots names after this. (e.g., xxx Xanthos). Vintel recognizes this as a request and checks the pilots listed.
To run or build from the source you need the following packages installed on your machine. Most, if not all, can be installed from the command line using package management software such as "pip". Mac and Linux both come with pip installed, Windows users may need to install cygwin to get pip. Of course all the requirements also have downoad links.
The packages required are:
- Python 3.7.x https://www.python.org/downloads/ Vintel is compatible with Python 3!
- PyQt5 http://www.riverbankcomputing.com/software/pyqt/download
- BeautifulSoup 4 https://pypi.python.org/pypi/beautifulsoup4
- Pyglet 1.4.6 (for python 3.7) https://bitbucket.org/pyglet/pyglet/wiki/Download pyglet is used to play the sound – If it is not available the sound option will be disabled.
- Requests 2 https://pypi.python.org/pypi/requests
- Six for python 3 compatibility https://pypi.python.org/pypi/six
- EsiPy Currently used for System-Statistics and Ship identification
- The standalone is created using cx_Freeze. All media files and the Setup.py with the configuration for cx_Freeze are included in the source repo. cx_Freeze can be installed via Pip.
License?
Vintel is licensed under the GPLv3.
Vintel does not play sounds - is there a remedy for this?
The most likely cause of this is that pyglet is not installed.
A litte bit to big for such a little tool.
The .exe ships with the complete environment and needed libs. You could save some space using the the source code instead.
What platforms are supported?
Vintel runs on Mac (OS X), Windows and Linux. Mac and Windows standalone packages are provided with each release. Linux users are advised to install all the requirements listed above then download and run from source.
What file system permissions does Vintel need?
- It reads your EVE chatlogs
- It creates and writes to path-to-your-chatlogs/../../vintel/.
- It needs to connect the internet (esi.evetech.net).
Vintel calls home?
Yes it does. If you don't want to this, use a firewall to forbid it. Vintel looks for a new version at startup and loads dynamic infomation (i.e., jump bridge routes) from home. It will run without this connection but some functionality will be limited. On crashes, it will also try and upload your Log-File to be analysed by Development
Vintel does not find my chatlogs or is not showing changes to chat when it should. What can I do?
Vintel looks for your chat logs in ~\EVE\logs\chatlogs and ~\DOCUMENTS\EVE\logs\chatlogs. Logging must be enabled in the EVE client options. You can set this path on your own by giving it to Vintel at startup. For this you have to start it on the command line and call the program with the path to the logs.
Examples:
win> vintel-1.0.exe "d:\strange\path\EVE\logs\chatlogs"
– or –
linux and mac> python vintel.py "/home/user/myverypecialpath/EVE/logs/chatlogs"
Vintel does not start! What can I do?
Please try to delete Vintel's Cache. It is located in the EVE-directory where the chatlogs are in. If your chatlogs are in \Documents\EVE\logs\chatlogs Vintel writes the cachte to \Documents\EVE\vintel
Vintel takes many seconds to start up; what are some of the causes and what can I do about it?
On first Start-Up if needs to load the Swagger from ESI and it will also load all Ships which are available in the Game. This will only happen on the very first Start-Up of Vintel or if you delete the Cache. Vintel asks the operating system to notifiy when a change has been made to the ChatLogs directory - this will happen when a new log is created or an existing one is updated. In response to this notification, Vintel examines all of the files in the directory to analysze the changes. If you have a lot of chat logs this can make Vintel slow to scan for file changes. Try perodically moving all the chatlogs out of the ChatLogs directory (zip them up and save them somewhere else if you think you may need them some day).
Vintel doesn't alert me!
If you start Vintel after you have logged into the game, it may not be aware where your pilots are located. It examines the EVE-Local-Chatlog to determine where you currently are. This gets updated once you change system or log in. To ensure the location of all your pilots, start Vintel before you log in to EVE.
Vintel is misbehaving and I dont know why - how can I easily help diagnose problems with Vintel
Vintel writes its own set of logs to the \Documents\EVE\vintel\logs directory. A new log is created as the old one fills up to its maximum size setting. Each entry inside the log file is time-stamped. These logs are emitted in real-time so you can watch the changes to the file as you use the app.
I love Vintel - how can I help?
If you are technically inclined and have a solid grasp of Python, contact the project maintainer via email to see how you can best help out. Alternatively you can find something you want to change and create a pull request to have your changes reviewed and potentially added to the codebase. There have been several great contributions made this way!
I'm not a coder, how can I help?
Your feedback is needed! Use the program for a while, then come back here and create issues. Record anything you think about Vintel - bugs, frustrations, and ideas to make it better.