README.md

Introduction

TagSpaces is a open source application for managing of your local files. You can find more information about it on its website tagspaces.org. For a quick TagSpaces introduction please see this video on youtube.

• TagSpaces blog for any news about tagspaces
• the issues tracker for developer support requests
• the TagSpaces wiki for end-users and implementors (currently not really used)

To get updates you can:

• Subscribe to GitHub updates by clicking the "watch" button up the top right of this page.
• Subscribe to RSS feed updates for the master branch

Repository Directory Structure

./data...............see the next lines
./data/assets........contains all the css and images used in the application
./data/ext...........contains the code of tagspaces extensions
./data/js............contains the javascripts which run the application 
./data/libs..........contains external javascript libraries together with the license they are distributed 
./data/chrome........contains files specific for the old NPAPI basse Chrome browser extension, which is not supported anymore
./data/chromelight...contains files specific for the current Chrome browser extension
./data/cordova ......contains files needed for the building of the Android application which is based on Cordova
./data/mozilla.......contains files needed for the Firefox extension based on addon sdk
./data/web...........contains files needed for the WebDAV/ownCloud based release of TagSpaces
./data/node-webkit...contains files needed for the windows, linux and mac os build of the application
./data/templates.....contains HTML templates needed for the UI
./data/locales.......contains files need for the localisation of the application UI
./data/_locales......contains files need for the localisation of the chrome extension UI

Downloads

You can find the latest release of TagSpace in the Releases Section

The full changelog is available here: Changelog

Features

• File managing & tagging: TagSpaces provides a convenient interface for browsing, viewing and tagging of your local files
• No-Cloud: TagSpaces is running completely serverless on your laptop, desktop or tablet and does not request internet connection or any kind of online registration or service provider.
• Note Taking: You can create and edit notes in plain text, markdown and html file formats
• Cross-platform: TagSpaces runs perfectly on Windows, Linux, Mac, Android and as extension in Firefox and Chrome.

Screenshots

Documentation

The native Windows, Linux and Mac OS X versions of TagSpaces are built with node-webkit. node-webkit is an app runtime based on Chromium and node.js. You can write native apps in HTML and Javascript with node-webkit.

How to run TagSpaces from the source code?

Get the TagSpaces source code by cloning its repository:

$git clone https://github.com/tagspaces/tagspaces.git

Run the native Windows, Linux or Mac OS X application

• Download nw.js prebuilt binaries for your system environment.
  • For Windows: copy nw.exe, nw.pak, icudt.dll, ffmpegsumo.dll to tagspaces/data/node-webkit directory.
  • For Linux: copy nw, nw.pak, icudtl.dat, libffmpegsumo.so to tagspaces/data/node-webkit directory. If you experience issue related to libudev.so.0 read the following article.
  • For Mac OS X: copy node-webkit.app to tagspaces/data/node-webkit directory.
• Run the nw executable file.

Run the Chrome/Chromium extension

• Go to the chrome Settings and then to Extension
• Enable the Developer mode checkbox in the upper right part of the screen
• Click on the Load unpacked extension... button
• Then select the tagspaces/data directory and click Open
• Activate the Allow access to file URLs check box in the TagSpaces entry, in order to enable the access to your local file system
• Start the extension by clicking on the TagSpaces icon in the upper right part of Chrome/Chromium

Run the Firefox extension

• Download and install the Mozilla Addon SDK following this article

• Start the SDK by executing source bin/activate in the Addon SDK folder

• Go to the your local tagspaces folder and run the following command, where the -p argument specifies some local firefox profile:

  $cfx run -p /tmp/mozprofile

• Start the addon by clicking the TagSpaces icon in the upper right area of Firefox

How to setup the WebDAV edition?

You can find information on this topic on the TagSpaces blog.

License

TagSpaces's source code is licensed under the AGPL (GNU Affero General Public License) Version 3, for the license text see LICENSE file.

Contribute

TagSpaces is an open source software and as such, the code is publicly available on GitHub, and forking is particularly recommended! Still, contribution must be done following some guidelines. Contributor License Agreement

The CLA is an agreement commonly used in major open source project, which aims at protecting all parties implied by a contribution : the contributor, the main code author, and above all, the community. The CLA model we have chosen basically tells the following : the contribution’s copyright is shared between the contributor and the main author. This means each party can do whatever she want in term of relicensing with this contributed piece of code. This is important, because, if in the future, the author wants to change the license in something more in favor of the community, a singular contributor cannot block the process.

The Contributor License Agreement can be signed online on the following CLA form.

Translations

You can help the translation of this application in your favorite languages by joining the translations teams on Transifex.

Support and Bugs

If you are having trouble using TagSpaces or have found a bug or you have some ideas how TagSpaces could be improved: open a ticket on GitHub.

Don't forget Tagspaces uses Javascript libraries from other projects, the full list of which is located in usedjslibs.md

Feeds

• Subscribe to RSS feed updates for the tagspaces blog
• Subscribe to RSS feed updates for the master branch

---

This files is created and edited in TagSpaces, using the viewerMD and editorText extensions.