gisto / gisto

Gisto is a Cross-platform snippets management desktop application that allows you and/or your team share code snippets fast and easily. Based on GitHub Gists Infrastructure which means you can use all your existing snippets by connecting your GitHub account! Gisto started as an attempt to fulfill the lack of a syntax highlighted and cloud synchronized code snippet solution. You may thing of Gisto as Evernote for code.

{ Gisto }

Snippets made awesome

• About
• Getting gisto
• Future and Status
• Screenshots
• Features
• Gisto previous version
• Latest builds
• Issues, bug reporting and pull requests
• Privacy/authentication
• How to help/contribute
• Development setup
• Run tests
• Release cycle
• License

About

Gisto is a code snippet manager that runs on GitHub Gists and adds additional features such as searching, tagging and sharing gists while including a rich code editor. All your data is stored on GitHub and you can access it from GitHub Gists at any time with changes carrying over to Gisto

Getting gisto

• You can download Gisto for (macOS, Windows, Linux) desktop from our website or from releases tab

• Use featured Web based client available at: https://web.gistoapp.com

Future and Status

Current released version is always on the branch master

Gisto next version in the works can be tracked via next branch

Please see next branch for upcoming version currently in development.

change.log of current version for more detailed info regarding new features, bug fixes and releases.

Changelog

Screenshots

Dashboard	Snippet view	Snippet options
Edit mode	Settings	Create new
CSV preview	GeoJSON preview	Images preview

FEATURES

• Advanced search
• Enterprise log-in
• Tags
• Syntax highlight
• Grouping by language
• Quick snippet actions
• Copy to clipboard
• Copy file contents to clipboard
• Open in external tools like plunkr, jsbin, carbon.now.sh, jsfiddle, etc.
• Editor settings
• Theme color changer
• Drag and drop to create files
• Comments
• Web app
• Open source

Preview of:

• Markdown preview (with emoji)
• AsciiDoc preview
• CSV and TSV preview
• GeoJSON preview
• Images preview (read only, pushed to gist by git)
• PDF preview (read only, pushed to gist by git)
• Open API/Swagger preview

And more...

Gisto previous version

Gisto v1 can be tracked via branch v1

This version considered obsolete and will not be updated

Latest builds

Latest builds in the releases tab

Issues, bug reporting and pull requests

Please feel free to add a bug / feature request / suggestions to the issue tracker.

Pull requests are very welcome

Privacy/authentication

Gisto authenticates to GitHub by using one of the following methods:

• Oauth2 - the default option on the log-in screen

• Basic authentication over SSL and retrieving an oAuth2 token. Thus the need for your GitHub user and password

• Access token - If you would rather to supply your own access token without providing Gisto your login details you may manually create an access token from the account settings at GitHub and login using the generated token

• Token via CLI - You can log-in with token by passing it to the executable as CLI argument (macOs example): open /Applications/Gisto.app/ --args --token 123123 (#183)

Gisto only saves the oAuth2 token received after authenticating and nothing else.

This token will be saved permanently until you log out.

You can find out more at the F.A.Q. section

How to help/contribute

• fix issues, pull request are very welcome
• write, improve docs
• write tests (we use jest)
• fix/contribute to Gisto's website (https://gistoapp.com)
• suggest features and improvements
• spread the word

Development setup

Make sure you have nodejs and npm installed in the development machine

Clone the latest "next" branch:

git clone -b next --single-branch https://github.com/Gisto/Gisto.git

Install dependencies in the directory created by cloning:

npm install

Run the local application (electron mode):

npm run dev

Run the local application (webapp):

npm run start:web (you will also have to run webserver from /web/ directory)

(for more commands, see package.json script section)

Run tests

npm run test or npm t

Release cycle

pre-release (beta from next branch)

• make changes on next brnch ONLY
• commit (this will run lint and tests)
• do not push, run npm run make:release:beta - will commit new tag with -beta.0 prefix and will also push

release

• make changes on next brnch ONLY
• commit (this will run lint and tests) and push
• do not push, run npm run make:release (for minor version), will update readme and changelog, add and commit new tag and will also push

License

MIT

gisto's Issues

Fix star fuctionallity

Currently you cannot unstar and then star again before loading the gist again.

Themes

Make gisto theme aware. Theme should be switched in settings dialog and reference saved in 'settings.json'.

corrupted downloads...

please fix your windows downloads...its corrupted.

Test for multiple logins of same user

When gisto is open on more than 1 device send notifications to all instances.

Notify all other clients when notification is read.

Bug: New gist tags not added to list.

New gist not adding tags into list upon creation.

Rewrite "JobIndicator" or make manual calls

Rewrite "JobIndicator" (or make manual indications).

Fix loading notification getting stuck in single gist view and being loaded twice.

I assume this happens due to the stars network call that fails.

Add: Drag & Drop in new gist

Drag & Drop files into new gist not implemented.

Edit dark themes colors

Offline access to gists

Allow offline access to gists.

EDIT: gathering all properties into one list of possible properties for this feature in one list from the suggestions in the issue

• Ability for search to search all gist text #100 (full text search)
• Aggregate all your gists in the background so they are always available in offline mode
• Diff conflicted gist and choose via 2 or 3 side-by-side column layout
• Notify users with large gist collection regarding implications and limits of Gist API (5000 requests/hour)
• Turn offline mode on/off via settings
• "Force sync" button on single gist
• Option to clear traces of sync at log-out (for security reason, while using Gisto on not trusted/public station)
• Ability to create gists while being offline.
• Ability to update gists while being offline
• Automatically sync gists when internet connection becomes available.
• Namespace user data so it will be possible to have multiple users without re-syncing everything.

Implement posting comments

Implement comment posting for a gist.
Live preview of markdown editing is a big plus.

Log-in screen usability

As Gareth suggests - add github word to place holder and spinner.

Create binary files and thorough build instructions

Create binary files for:

• Windows x86
• Linux x86/64
• Mac x86

Maybe .deb/.rpm packages and archlinux instructions

Create thorough build instructions for guys and gals who wish to build themselves.

Unable to save after drag&dropping file into gist.

Unable to save after drag&dropping new file into gist.

Messaging/ Notifications after log-out or user change.

When changed to other user without closing Gisto - the notification service still thinks I am on previous user.

Change Cancel button to Done when editing a single gist

Or make it revert to the original and add a done/save button next to it

Add [x] to remove empty area in "create gist."

Add [x] to remove empty area in "create gist."

Stop unnecessary network calls

Mainly related to login and stars.

login calls for gist data too soon and stars is being called when a gist is loaded.

Fix login flow

When logging in there should no need for refresh to display your data.

Allow user to decide on editor height settings (min-height, max-height or none at all)

Implement in the settings window under editor settings.

Should have a raw input box allowing the user so specify the numbers in pixel units.

Fix all 404 issues

Make sure that anything that gets a 404 is cancelled if not needed or fixed if needed.

See what to do with gists list animations.

Check options to leverage timing or remove completely.

Indicate starred at gist list

Indicate starred at gist list.

Add tooltips to single gist view

Add tooltips to the file view buttons.

Show comments upon clicking anywhere in the comments bar not just the show

Redirect to initial screen after deletion of a gist

Gravatar got cached

Gravatar get somehow cached between user login/logout.

Disallow to save gist with empty file content

Disallow saving gist with empty file content.
Suggestion: warn the user.

Merge templates to one scope

Merge templates to use single scope.

Show login error message when login unsuccessful

Source maps to use with grunt

Create source maps to assist grunt tasks.

Auto fill filename based on description on create gist screen

Generate a filename based on the description using a slug based system(?)

such as:
Apache redirect 301

apache-redirect-301.txt

Create language select drop down on create gist view

Bonus - change the editor highlighting based on the drop down.
default should be txt.

Maybe look at most used languages and offer these as quick buttons.

Dates meta on single gist toolbar need to adopt to app window width.

Big window:

Smaller window:

Allow to change "public" or "secret" state of existing gist.

Allow to change "public" or "secret" state of existing gist.

Some notifications fail to unload.

Some notifications fail to unload.

Allow open gist in plnkr

I guess we need to check if there is index.html file present among the files for preview.

URL example: http://plnkr.co/edit/gist:{{gist.id}}?p=preview

Create settings functionality.

Create setting functionality to save in localStorage.

Add application header to the initial screen

Allow deleting single file from gist.

Allow user to be able to delete single file(s) from gist.

Fix to clipboard button

Create ability to copy to clipboard from file.

Tooltips for editor buttons are not showing such as: copy to clipboard

Move notifications to bottom right corner.

Move notifications to bottom right corner. Current location is a bit annoying by moving the editable area.

Single gist view: check for changes before saving

If there are no changes skip saving.

Update angular-ui

Update angular-ui to v0.0.3

Fix login

Fix login to work hand in hand with settings.

Add drop down with file list in a single gist.

To ease the navigation inside gist.

Make comments scroll

Make comments scrollable on single gist view.

New name

Come up with a new name for the app.

Messaging/Notifications Detect when internet connection becomes available again and reconnect to server

Only happens if the application was started in an offline enviorment, socket.io will not send additional requests to the server because it knows it is offline.