Skyperious

Skype SQLite database viewer and merger

Index
Downloads
Screenshots
FAQ
Changelog
Help Texts
View the Project on GitHub suurjaak/Skyperious

Skyperious is a Skype database viewer and merger, written in Python.

You can open local Skype SQLite databases and look at their contents: and

Additionally, Skyperious doubles as a useful database browser for any SQLite file.
Also, a command line interface is available with key functions like exporting, searching, and merging.

Making a backup of the database file is recommended before doing any changes like merging.

Using The Program

Skyperious can look through user directories and detect Skype databases automatically, or you can select specific files or folders. Once added to the database list, a file can be opened for browsing, searching and exporting, or compared with another database for merging.

Searching an opened database supports a simple Google-like query syntax. You can use keywords to search among specific authors or chats only (from:john chat:links), or from certain dates only (date:2010..2013). Search supports wildcards, exact phrases, grouping, excluding, and either-or queries.

In database comparison, you can scan one database for messages not found in the other, and copy all detected messages to the other database. Or you can browse and copy specific chats and contacts.

Skyperious offers a number of options from the command line:

  export FILE [-t format]    export Skype databases as HTML, text or spreadsheet
  search "query" FILE        search Skype databases for messages or data
  merge FILE1 FILE2          merge two or more Skype databases into a new database
  diff FILE1 FILE2           compare chat history in two Skype databases
  gui [FILE]                 launch Skyperious graphical program (default option)
More information on search syntax and command line interface.

Skyperious has been tested under Windows 7, Windows Vista, Windows XP and Ubuntu Linux, and reported to work under OS X and Windows 8. In source code form, it should run wherever Python and required Python packages are installed.

Installation

Windows

Download and launch the latest setup.

Mac

Download and extract the Skyperious source, launch skyperious.sh.

Ubuntu/Debian

Launch skyperious.sh.

Vagrant

If you have problems using above methods, you can try using Vagrant.

Pre-requisites:

Clone this project and get it running:

   git clone https://github.com/suurjaak/Skyperious
   cd Skyperious/packaging
   vagrant up

A vagrant up will do the following:

Steps for using the Vagrantfile:

  1. vagrant up
  2. A VirtuaBox window will appear
  3. Wait until vagrant up finishes setting up the VM
  4. Log into the console as the user vagrant, password vagrant
  5. Run startx -- :1
  6. Now you are in ubuntu desktop env
  7. Open a terminal
  8. cd /vagrant
  9. ./skyperious.sh &

To have your Skype DB files accessible within the VM, place them in project directory.

Vagrant support provided by Alberto Scotto and Elan Ruusamäe.

Dependencies

If running from source code, Skyperious needs Python 2.7 or 2.6 (www.python.org),
and the following 3rd-party Python packages:

If wxPython is not available, the command line interface will function regardless.

The following 3rd-party Python packages are not strictly required, but provide additional functionality like Excel export, contact import, and convenient date period choices in chat history:

* Skyperious can also run under wxPython 2.8.12+, with some layout quirks.
   Python 2.6 will need the argparse library. Python 3 is currently not supported.

Attribution

Skyperious has been built using the following open-source software:

Emoticon images in HTML export are property of Skype Limited, © 2004-2006, released under the Skype Component License 1.0.

Default avatar icon from: Fancy Avatars, © 2009 Brandon Mathis, http://brandonmathis.com/projects/fancy-avatars/

Several icons from: Fugue Icons, © 2010 Yusuke Kamiyamane, http://p.yusukekamiyamane.com/

License

(The MIT License)

Copyright (C) 2011-2014 by Erki Suurjaak

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

The software is provided "as is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the software.