qasim/README.md

90 lines
2.8 KiB
Markdown
Raw Permalink Normal View History

2023-03-21 16:45:22 +00:00
# Qasim (القاسم)
2015-11-26 05:13:51 +00:00
2017-10-14 10:02:08 +00:00
[![Travis-CI](https://api.travis-ci.org/glenux/qasim.png?branch=master)](https://travis-ci.org/glenux/qasim) [![Code Climate](https://codeclimate.com/github/glenux/qasim/badges/gpa.svg)](https://codeclimate.com/github/glenux/qasim)
2015-11-26 05:13:51 +00:00
2014-10-29 23:02:48 +00:00
Qasim is a tool born to make your remote shares easily available from the system
tray, on your desktop !
2013-10-24 14:27:02 +00:00
2017-10-14 10:02:08 +00:00
It uses the FUSE filesystem, thus everything gets accessible both on graphical environments and under
command-line shell, on your favorite operating system (Linux, Windows, MacOsX, etc).
2012-07-24 00:24:59 +00:00
2012-07-24 00:28:46 +00:00
2017-10-14 10:02:08 +00:00
## Requirements
2012-07-02 18:48:50 +00:00
2017-10-14 10:02:08 +00:00
Qasim require the `qtbindings` gems. It installs automatically along Qasim's
2014-10-29 23:01:28 +00:00
installation, but is quite long to build a native gem package.
2012-07-02 18:48:50 +00:00
2017-10-14 10:02:08 +00:00
__N.B :__ If you experience trouble with Qasim dues to Qt bindings, make sure
your Ruby installation was compiled with the `--enable-shared` option. If it was not, then reinstall it with the right arguments.
2012-07-02 18:48:50 +00:00
2017-10-14 10:02:08 +00:00
As an example, for ruby 1.9.3-p392 with rbenv :
2012-07-02 18:48:50 +00:00
2014-10-29 23:01:28 +00:00
$ CONFIGURE_OPTS="--enable-shared" rbenv install 1.9.3-p392
2012-07-02 18:48:50 +00:00
2017-10-14 14:04:08 +00:00
For others versions of ruby with rbenv you can try :
$ CONFIGURE_OPTS="--enable-shared" rbenv install $(rbenv version |awk '{ print $1; }')
2012-07-02 18:48:50 +00:00
2017-10-14 10:02:08 +00:00
## Installation
2012-12-03 15:07:05 +00:00
2017-10-14 10:02:08 +00:00
To install Qasim, type the following command :
$ gem install qasim
2023-03-21 16:46:22 +00:00
## Usage
2017-10-14 10:02:08 +00:00
Qasim two tools : the CLI, for command-line environments, and the GUI, for desktop environments.
### Using the CLI
2017-10-14 10:02:08 +00:00
To run the CLI, type :
2014-10-29 23:01:28 +00:00
2017-10-14 10:02:08 +00:00
$ qasim-cli command [options]
### Using the GUI
To run the GUI, type :
2014-10-29 23:01:28 +00:00
2014-10-29 23:03:22 +00:00
$ qasim-gui
2014-10-29 23:01:28 +00:00
2017-10-14 10:02:08 +00:00
Then Qasim icon (![quasim system tray](data/icons/qasim.32.png)) appears in your system tray. Click on that icon to mount your filesystems, change your preferences, etc.
2017-10-14 10:02:08 +00:00
## Contributing
1. Fork it ( http://github.com/glenux/qasim/fork )
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request
2012-12-03 15:07:05 +00:00
2012-07-28 13:20:21 +00:00
2017-10-14 10:02:08 +00:00
## Copyright & License
2012-07-28 13:20:21 +00:00
2017-10-14 10:02:08 +00:00
Copyright (C) 2010-2017 Glenn Y. Rolland
2012-07-28 13:20:21 +00:00
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
2017-10-14 10:02:08 +00:00
## Alternatives
If Qasim does not suit your needs, you can try these tools :
* [Mountoid](http://kde-apps.org/content/show.php/Mountoid?content=115943)
2015-08-28 16:17:35 +00:00
* [Xsshfs](http://david.mercereau.info/motclef/xsshfs/)