EyeFTP

From eyeOS Wiki

Jump to: navigation, search

eyeFTP is the eyeOS client to connect to FTP servers through eyeOS. You can use it to browse, transfer and manage files on a remote server, using your eyeOS host server as a proxy for your connections.

Author: Nanawel
eyeFTP v3.0.0 screenshot
eyeFTP v2.0.0 screenshot


Main features

Main features

  • Connect to any FTP server through the machine hosting your eyeOS
  • List files with their details (name, size, date, ...) and browse folders
  • Create folders
  • Delete, rename and move files and folders
  • Download and upload files from/to eyeOS
  • Download and upload files through eyeOS:
    • First transfer between FTP and eyeOS,
    • then between eyeOS and your local machine, depending on transfer direction

       so you can download/upload files from/to FTP servers even if your port 21 is unusable.

  • Save and manage connection profiles


Downloads

Downloads


3.x.x Serie (eyeOS 1.5+) 2.x.x Serie (eyeOS 1.0 - 1.2.x.x) Intermediate releases (deprecated)
(eyeOS 1.0 - 1.2.x.x)
3.0.0 release
(Deprecated - Use the eyeOS built-in version)
2.0.5 *final* release 2.0.4 release

2.0.3 release
2.0.2 release
2.0.1 release
2.0 release
beta 1.1 release
beta 1.0 release
alpha 0.3.1 release
alpha 0.3 release
alpha 0.2 release


News

News

You may want to take a look at the changelog as well. If you would like to follow more on the history of eyeFTP you can visit eyeFTP Archive

2008-Apr-25

Release 3.0.2 is out!
Like many applications in the new eyeOS 1.6 release, eyeFTP has been improved!
Now the window of the application can be resized and maximized. Some refresh problems have also been fixed.
Since this application is now fully integrated in the default eyeOS system, no external package will be available for this release. This is also due to the fact that some used features are only available in the latest eyeOS version.

2008-Jan-15

Release 3.0.0 is out!
Following to the huge improvements included in eyeOS 1.5 "Gala", eyeFTP had to be upgraded to the latest evolutions of the API. That's why I entirely redesigned the app for a better integration in the new version. I hope it will be appreciated, feel free to submit suggestions and report bugs in my mailbox!
Download the package: 3.0.0 release

2008-Jan-09

Release 2.0.5 final is out!
This version is the last one of the 2.x.x serie. It is made to keep a full compatibility with eyeOS versions before 1.5. A brand new version 3 is currently in testing phase and will be integrated in the new eyeOS ([download the RC2 here]).
Download the package: 2.0.5 release


Help

Help

FAQ

FAQ Why do I have this ugly display when using Internet Explorer?

Because as many softwares Microsoft provides, Internet Explorer meets Microsoft's and not W3C standards.So the PNG icons often have a grey background instead of a transparent one, and the space layouts are not well respected.I advise you to use Mozilla Firefox (or Opera, even if some problems could appear with it) to use eyeFTP, eyeOS, and most generally to browse the Web.

However, despite those display-related problems, you can use all the features provided by eyeFTP from Internet Explorer.

FAQ I tried to download (or upload) a "big" file from/to a FTP server with eyeFTP but after a while nothing happens or I get an error message. Why?

This question is quite pertinent and I need to bring some light on it.

("TECHNICAL" EXPLANATIONS FOLLOW, BE ADVISED)
As you could suppose, eyeFTP runs on the server holding eyeOS, which is an HTTP server (Apache in most cases), well. This server, when you browse an FTP server, plays the role of a kind of proxy. So every action you make to the FTP server from your browser with eyeFTP, actually this is the HTTP server which really makes it for you, including transfers.In this connection, the transfer processings are made twice, for instance in the case of an upload: once from your computer to the HTTP server, then from the HTTP server to the FTP server. This explains why transfers are longer than with a classic FTP client.From the last example, the second transfer is handled by the HTTP server through PHP. But this one has a security protection which makes that an operation (a request you make) cannot last more than a defined time (30 seconds by default). After this time, the operation is stopped, even if the process (your transfer) has not finished yet.
(END OF "TECHNICAL" EXPLANATIONS)

So, to sum up, the different problems that could lead a transfer to fail are:

- your file is bigger than the limit the HTTP/PHP server can handle (2 MBytes by default, can be changed in the configuration file) [UPLOAD]

- the HTTP/PHP server does not have time enough to perform entirely the operation because of the security protection (see above) [DOWNLOAD/UPLOAD]

- other reasons can be that the PHP server is not authorized to create temporary files big enough to hold your data [DOWNLOAD/UPLOAD]

FAQ Why do I have problems to transfer files with names containing special characters when using my eyeOS server running under Windows?

This is a character encoding problem. A lot of (public) FTP servers run under *NIX so they use a standard called UTF-8. If your eyeOS server is installed on a Windows platform (using ISO-8859-1 standard encoding for example), you may encouter problems with accents and other special characters when trying to download files from FTP to your eyeOS because of the encoding differences.

There is no real solution except of course to avoid using accents and non-ASCII characters in filenames.

FAQ Why the problem I encountered is not solved here?

Because there is so many little troubles that could happen that I did not experienced them all.You are free to send me an e-mail with its description so I can try to fix it or explain in this section why it may happen.


Additional informations

Additional informations

  • Data transfers are done in passive mode (releases 2.0.3 to 2.0.5 only, mode can be chosen with 3.x.x releases)
  • Passwords are stored in the user's configuration file without any encryption. Just pay attention to that.
  • FTP operations performed by eyeFTP are supported by the standard PHP API, which is quite limited. It may partially explain the limitations of the app.
  • If a problem appears during execution (files list not well refreshed, etc.), close eyeFTP and run it again. This is mainly due to a bad interpretation of special characters in filenames.


Development

Development

If you would like to follow more on the history of eyeFTP you can visit eyeFTP Archive

Known bugs

3.x.x

  • Still encoding problems with some servers
  • Remote files list does not perform an automatic refresh after a client->FTP upload (Firefox 2.0.0.11)

"Stable" 2.0.x

  • (None at that time)
Encoding troubles can be avoided not using filenames with accents and special characters.


ToDo list

  • Feel free to add tasks! (sign with your [nick]name)
  • Possibly SFTP support (I have no idea how hard I would be to implement)
    • Answer: Yes it could be a good feature. But currently there's no library easy to use in the PHP API, and I can't be sure how secure the result would be anyway. If someone has a more precise idea, let me know!
      • Have you considered http://ca3.php.net/manual/en/function.ssh2-sftp.php ? The documentation itself is a bit sparse, but the comments should help you greatly. Keilaron 22:51, 11 September 2008 (EDT)
        • Answer: I saw this library previously, but it is not default one. In any case, it's a very interesting and needed feature for eyeFTP so I'll probably add it in a near future. Thanks. Nanawel 17:24, 14 September 2008 (EDT)
  • The IE-png issues can easily be fixed in an IE-specific way (that is, in a way that will not affect other browsers not validity - I'm not sure how easy it is to add CSS in an eyeApp though). You use a filter to accomplish this. Keilaron 22:51, 11 September 2008 (EDT) DONE (I guess)
    • Answer: That's right. And that's what is done in other parts of eyeOS I think. I'll see this with the Core team. Thanks. Nanawel 17:24, 14 September 2008 (EDT)
  • Add i18n support DONE
  • Copy directories? (this would solve a problem copying many files into EyeOS from "localhost").
    • Answer: Very good feature. I thought about it previously but never had time to code it. I keep it in mind for a future release! Thanks! Nanawel 16:00, 9 September 2008 (EDT) DONE
  • The ability to mount a ftp directory to a local directory.--Mo0n sniper 16:29, 14 July 2009 (UTC)
    • Answer: eyeFTP is just a client application. Mounting FTP directories is not its responsibility, but the filesystem's. In eyeOS 1.x this feature is not planned because it is not adapted to and it may produce a lot of side effects. But this is an already planned feature for eyeOS 2.0. Thanks! Nanawel 20:25, 19 July 2009 (EDT)

Changes, improvements

3.3.0

(integrated in the eyeOS 1.8.0.4 release on March 8th 2009)
  • Fixed bug with authentication error due when using password
  • Added folders transfers support!
  • Added recursive folder deletion support
  • Added directives to prevent PHP from cancelling an incomplete request (time_limit/max_execution_time)

3.2.1

(integrated in the eyeOS 1.8.0.2 release on January 27th 2009)
  • Fixed bug introduced with the LIST -a feature
  • Added splitter widget between the local and remote view
  • Added connection string argument support at launch

3.2.0

  • Added option to enable/disable "-a" as LIST argument
[Missing information]

3.1.0

(integrated in the eyeOS 1.6.0.1 release on May 27th 2008)
  • Redesign of the "Manage hosts" dialog
  • Added "Enter" events to the textboxes (now you can just hit "Enter" to execute the action)
  • Improved console (icons, colors, right direction scrolling, ...)
  • Fixed problems with sorting on the tables
  • Additional bugs fixes

3.0.2

(integrated in the eyeOS 1.6 release on April 25th 2008)
  • Added window resize feature
  • Improved refresh of the files tables (no more "ghost" remaining line)
  • Fixed bad directory files listing on connect
  • Minor bugs fixes

3.0.1

(integrated in the eyeOS 1.5 release on January 15th 2008)
  • Added double-click support on the hosts table
  • Additional bugs fixes

3.0.0

  • Entire redesign of the app, many things added!

Stable 2.0.5

  • Fixed bug introduced in 2.0.4 (with double-click) with rename and delete operations
  • Additional bugs fixes