If you are you a GSOC student or and have questions about = About Amahi, you can contact us via IRC on [http://talk.amahi.org #amahi on irc.freenode.net] (fairly active) or on the amahi-devel [[mailing list]] (not as active).=

If you are a studentWe're looking for students with skills in these areas: current technologies like RoR, ruby, python, PHP, come talk to us about the ideas below as well as next generation technologies, like Go (we use it for possible projects! Don't forget that these are subject streaming to suggestionsour mobile apps), extensions or adaptations[https://nodejs. Even new ideas will be consideredorg/ Node. Some of these ideas are more mature and concrete than othersjs], [https://github.com/amahi/spdy HTTP/2], javascript frameworks for user interaction, visualization or server services, etc.

One of the most important things is to find an area that you '''enjoyWe''', using re also looking for hardware projects! Creating a programming language Raspberry Pi-style device with great I/O that you know or that you are willing to learn, so read below or ask questions. If you are interested in being can run Amahi smoothly is a mentor, we have six great mentors as of today, but we're very welcoming of more ideas and more mentors! See the [[#Mentors]] below. Looking long-tem goal for ideas to mentor, see the [[#Other Ideas]] below. = About Amahi=!'''

Amahi is a full and proper server made up of* A Linux system based on a mainline distribution, currently Fedora, but we support supported Ubuntu before as well

At Amahi we use [https://github.com/amahi git] for our version management = What to do (and the technologies we have ended up using are Ruby, Ruby on Rails, generally Linux system internal technologies like system services, configuration areas, web server virtualhosts, databases, DNS, etc., etc.NOT do) first =

WeLet're looking for students who are interested s talk about what NOT to do first, because many people automatically start badly by doing these:* do '''not''' comment randomly in github issues, e.g. introducing yourself in both current technologies a GH issue, saying you would like RoRto do something, as well as next generation technologies we are using or could be using, like Go (we use just "make noise"* do '''not''' blindly try to build things without understanding what Amahi is and what it for streaming does* do '''not''' just submit a pull request or issue a bug without really knowing what you are up to* do '''not''' just come to our mobile apps)IRC, Nodesay something and vanish shortly thereafter.js, javascript frameworks Stay for user interaction, visualization or server services, [https://githuba while. People come and go.com/amahi/spdy SPDY], etcAsk your question and stick around. etcGet a client that can linger for a while.Sometimes it takes hours for some people to return

BUT First, Introduce yourself, interact with the community, so please [https://docs.google.com/forms/d/e/1FAIpQLScP4Q2iSzLXCjz1gK2eNutO8IhX_PETXU2bL8pqmhe2t1nCqg/viewform?usp=List of Project Ideas=sf_link introduce yourself with this form], so that we know your background and interests.

'''Description''': Make the ability to create and install [https://github.com/amahi/platform/blob/master/doc/plugins.md Amahi Plugins] easy and enable the creation of those plugins for If you are interested in being a mentor, we have a variety few great mentors as of purposestoday, like SMART monitoring, system stuff (network scanning, etc.) and the two examples below for the disk wizard but we're very welcoming of more ideas and the Greyhole UI, among other ideas.more mentors!

'''Objective''': Create an amahi plugin system, where PHP, Python, Node, and other modern webapps can be easily integrated. We can currently do this with some RoR engines, but See the mechanism is not robust enough[[#Mentors|mentors]] below. The plugins system should allow modern web-based apps Looking for ideas to be easily integrated with Amahi -- from Node.js apps to Ruby/PHP/Python -- so that users can easily reap mentor, see the benefits of the onslaught of difficult-to-deploy modern web apps with a single click install[[#Other Ideas|other ideas]] below.ProTip: possibly leverage docker containers within Amahi

We have organized the ideas in groups, depending what area of Amahi they belong in. These groups are not in any particular order. For instance if you are a front-end person who knows HTML and Javascript, the GUI/UX may well be the best fit and we'''Mentors''': Carlos, Rodd love to hear from you!

===Disk Wizard=Platform ==

'''Objective''': Create an amahi plugin Plugins are "mini apps" that will streamline this process by providing a UI live inside the Amahi platform and thus little interface need to be developed for disk managementthem. The plugin should detect if a new disk was added They are familiar and it should provide a wizard easy, focused value to create partitions and format with the desired file systemuser. Ideas:

* Support for automatic issuing/renewal and installation of [https://letsencrypt.org/ Let'''Skills Required'''s Encrypt] certificates in the platform, for external access across the internet* [https://bugs.amahi.org/issues/1361 Share space usage]: Using [http: Low level //d3js.org D3.js] (for example) to visualize things internal to the system scripting, gitlike finding out the disk space used by shares, disk usage over time, etc.* [https://bugs.amahi.org/issues/1480 Wake-on-LAN (WOL)]: The Amahi [http://www.amahi.org/apps/wake-on-lan-server Wake-On-LAN Server] app currently provides this capability.* [https://bugs.amahi.org/issues/1481 Virus Scan Shares]* [https://bugs.amahi.org/issues/1489 Netboot Settings/Configuration]* [https://bugs.amahi.org/issues/1487 Mail Relay] (i.e. using Gmail or ISP)* [https://bugs.amahi.org/issues/1459 Convert app] [https://www.amahi.org/apps/Amahi-energy-saver Amahi Energy Saver] to a plugin.* View log files in web browser ([https://github.com/tobi/clarity Clarity using RoR])* Ability to update default SSL certificates (used by [https://www.amahi.org/apps/openvpn OpenVPN], [https://www.amahi.org/apps/amahi-anywhere Amahi Anywhere], etc).* AmahiTunes revival* RAID (SW, MDADM?) support* [https://bugs.amahi.org/issues/1458 SMART Disk] monitoring

'''Description''': === [httphttps://www.greyholeamahi.netorg/apps/ Greyholedisk-wizard Disk Wizard] is an application that uses Samba to create a storage pool of all your available hard drives (whatever their size, however they're connected), and allows you to create redundant copies of the files you store, in order to prevent data loss when part of your hardware fails. The purpose of this plugin is to provide a UI and the necessary tools under the UI to make starting and managing a Greyhole UI possible and nice to understand for regular humans.===

'''ObjectiveDescription''': Create and amahi plugin that provides Expanding the storage capacity is an UI that allows for the management important feature of the greyhole poolAmahi. The plugin DW is a critical part. However, it's not as stable as it should allow an administrator user to:add/remove disks to/from the poolbe.* change the number of copies for individual file/directory* invoke various gh commands* view It should detect more partition types and monitor log files* gui to visualize data distributionhandle everything gracefully, even when it can't act upon certain configurations.

'''Skills Required''': RoR, System programming, gitLow level system scripting

'''Mentors''': Rod, Carlos, Rod

===Amahi 8=== '''DescriptionReferences''': Amahi 7* [https://bugs.2 and Amahi 8 are what's nextamahi. This is org/issues/580 Track the time to come up with exciting features and disk wizard]* [[New Disk Wizard]] ideas page* [http://www.openmediavault.org/ OpenMediaVault] does have a nice wizard that we should put in Amahi 8.people like

'''MentorsDescription''': Carlos, Rod[[Amahi 12]] is our next release.

===Backup App Data '''Objective''': Work closely with the core team to define the features and Settings===functionality that we need to implement to get Amahi released. This project is about working on RoR and the Amahi platform core. Some of the core technology will need to be upgraded, like Rails 5, latest Phusion Passenger, possibly replace MySQL for the platform, create a native API to the platform that can be used by other apps, like mobile apps. Other ideas include beefing up security and provide support for Amahi hosting on the cloud. Features:

'''Description''': When new versions * make platform even more modular and cleaner (at the moment we still have some things that really belong in plugins but still are in controllers/views of Amahi come out, the main app)* possibly using a drawback new metal layer instead of Amahi is passenger - especially ones that it's hard do not take a long time to backup the settings (ereload, could be puma, i also like thin, maybe others* better initialization ..g. partitioninglike a more standard (wordpress-like) installed applications initialization wizard (initially there are no users, we need to create an admin user and their user dataperhaps ask a few questions and integrate with amahi.org)* Implement sharing of folders among the friend servers.

'''Skills RequiredMentors''': System scriptingCarlos, gitRod, Sukhbir

'''MentorReference''': Rod, Daniel[https://github.com/amahi/platform Amahi Platform repo]

==Android MobileApp==

Mobile is Our mobile apps have streaming, browsing and sharing and it's a great topic at the moment and there are a lot of opportunities here. In the Android app, definitely more than one student are suitable for the project.

===This year we're going to try emphasizing the Android App Implementation===app a little more.

'''Objective''': An ===Android app that is on par or better than the iOS app, including mobile streaming, downloading files and sharing them.App Improvements===

'''Skills RequiredDescription''': Java, Amahi Android offers the ability to stream your HDA over your Android, REST, JSON API programming, media interaction in phone and AndroidTV, gitsupport for Chromecast and auto-upload of images to HDA. The next step is to complete the following objectives:

'''MentorObjectives''': Jesse Read, Carlos, Bogdan

===Webapp Browsing * Android TV Revamp: The Android TV app is outdated at the moment and doesn't follow the latest design principles of Android. We have to redesign the app so that Amahi is accessible on Android TV again. Further, we have to implement the PlayerAdapter in Mobile apps===Android TV to support previews.* Support for Dagger 2: The current app is written using Dagger 1. We have to port the code to Dagger 2 so that we can use the latest libraries which are dependent on it.* Support for NAU: Complete the app with support for Non-Admin User which currently exists on the server-side only. Ref: https://docs.google.com/presentation/d/1jZAdXpSGQRJ6xN2WCzqkiPxQPUW2VHsAnpENZKbT2z0* UI Improvements and UI Testing: Adding an Expresso based automated UI testing protocol.* Improve Background Service: Improve the app for uploading media on the HDA when the app isn't present in the foreground* Phone Auto-Backup: Develop a module that does an Auto backup of the phone to the HDA over Local connection (reference: Helium)* Friending Feature: Implement the sharing of folders or shares with other servers. https://docs.google.com/document/d/14JsH9-aZrE3Z-35Oo38IY1-3Nd5BJiR_G0DshhjKSM4/* VPN: Add support for VPN proxy so that the user can access the HDA from the phone over a VPN proxy tunnel.

'''ObjectiveSkills Required''': One requested feature for our mobile app (iOS and later Java, Android) is the ability to browse apps within our mobile app. Our server side of the app needs to be setup to proxy specific webapps that the user has installed.Collaboration with the iOS/Android devs will also be necessary to prototype itframework

'''Skills RequiredMentors''': Go programmingCarlos, gitChirag

'''MentorsReference''': Carlos, Bogdan[https://github.com/amahi/android Amahi Android Github repo]

'''Reference''': [https://gitbut.org/amahi Amahi Github repo], in particular the SPDY and SPDY-proxy repos written in Golang ===iOS App Improvement=Apps==

'''Description''': While Amahi has an [https://www.amahi.org/ios iOS] application already Innovative app or app packaging and it's ''loved'' among our users, there is a lot of room for improvement. For this project, we're looking to improve the existing iOS application and expand it's feature set. We're striving to make Amahi for iOS a polished, fast, and enjoyable application for our usersapp-related projects.

'''Skills RequiredObjective''': *Objective-C/Cocoa*Experience programming against For the example of generating their own certificates, build a REST API wizard to allow users to create and manage their certificates. Another goal would be helpful (Even input to provide logging of VPN connections, so that the user can see the activity on improving and expanding the API!)their VPN.

'''Mentors''': Jesse ReadRod, Carlos '''Reference''': [http://www.amahi.org/ios Amahi for iOS] ==Reliability== ===CI Server for Apps=== '''Description''': App reliability is critical for Amahi. We have been striving to develop a customized CI (Continuous Integration) server for testing apps. '''Objective''': Develop up a CI server for apps (we have been calling a prototype "the app grinder") . The goal is to achieve 100% app installation and reliability. An important goal is to support a tester program for Amahi. We have a number of ideas of what we want to achieve -- how to design the CI server so that testers can easily see their passes, failures and anything in between. '''Skills Required''': Capybara, ruby, Webkit, Selenium, git, maybe Vagrant and system scripting. Other possible technologies could be Jenkins, Travis, etc. '''Mentors''': Carlos, Bogdan ===App Sandboxing=== '''Description''': Use containers to improve app stability '''Objective''': Some apps may be more suitably installed inside a container because they may be too disruptive in a system. Can we you use popular sandboxing environments to contain apps that want to take over things, like Zimbra, or some PBX/VoIP systems, etc. '''Skills Required''': [http://docker.io Docker], Vagrant (for testing), ruby, bash, [http://pdos.csail.mit.edu/mbox/ Mbox], git '''Mentor:''': Carlos, Bogdan == Apps== Innovative app packaging or app related projects.

'''Objective''': Develop and a plugin that will allow an administrator user to control the traffic for specific devices inside the network. This app (or possibly a plugin) should display all the connected device as well as provide the ability to search by name/MAC address. For a selected device the administrator should:

'''MentorsSkills Required''': Daniel, Jessesystem configuration and scripting

===Network Groups=== '''Description''': Develop a plugin to allow network device grouping. This will be the framework for future plugins. '''Objective''': Allow an administrator to group network devices in groups with different permissions. Limit the user access to certain apps based on the group settings. '''Skills Required''': RoR, system programming, git '''Mentors''': JesseCarlos, DanielRod

'''Skills Required''': RoR, system programming, git

'''Mentor''': Carlos, Rod, DagSukhbir

'''Description''': Improved installation experience for users. For example, create a new [https://fedoraproject.org/wiki/Anaconda Anaconda] node for Amahi configuration. Similarly for Ubuntu.

'''Objective''': Configuration and installation of Amahi can be painful for some percentage of users. Many who of them do not know much or care about for Linux. We want to make the installation as smooth as possible not just for them, but for more even more regular (non-techy) users. Ubuntu has some challenges of its own to make it work without dropping the users to the command line.* Create a new [https://fedoraproject.org/wiki/Anaconda Anaconda] node for Amahi configuration* Similarly for Ubuntu

'''Mentors'''Idea: Carlos, Daniel, Jesseuse [https://github.com/diafygi/webrtc-ips this package ] to help improve installation networking issues.

'''DescriptionMentors''': Help users get their HDA up and running with minimal interaction after installationCarlos, Rod

'''Objective''': Happier users. The idea is to implement an automated configuration check tool. The current [http://www.amahi.net ==Amahi Interactive Troubleshooter] can be used as a starting point. The tool should:* check if the installation was successful* compare current settings against the expected settings* automatically fix inconsistencies with no user interactionAnywhere==

'''Skills Required''': RoRThe mobile apps use API endpoints provided by Amahi Anywhere for browsing, scripting, netflow capture, dhcping scripting, gitdownloading and streaming files and more.

'''MentorsReferences''': Daniel, Carlos* [https://www.amahi.org/apps/amahi-anywhere Amahi Anywhere App]* [https://github.com/amahi/amahi-anywhere-specs Amahi Anywhere Specs]

===Ubuntu 14.04Improvements in AA File Server===

'''Description''': Get Amahi ready for [https://wiki.ubuntu.com/TrustyTahr/ReleaseSchedule Ubuntu 14.04]Anywhere File Server exposes HDA files and directories via REST APIs and also allows to upload new files

'''Objective''': Further development on the Amahi platform to Following features can be able to install the same applications and have the same features as the Fedora based version. A new install CD package that allows you to add Amahi functionality to Ubuntu 14.04 (LTS)implemented:

'''Skills Required'''* API to access platform apps over remote via proxy* Better logging ([https: ruby//github.com/amahi/amahi-anywhere-fs/issues/4 Issue #4])* Simplistic dashboard to view some metrics like number of users connected, ISO creationaccess logs for each user, gitsystem health etc.* API to fetch metadata (duration, codec, album art image, title, artist name, album name, year etc.) for audio / video files* Create and cache low resolution thumbnail for image files for faster loading and enhanced experience

'''DescriptionReference''': Create a system to create data nodes that integrate with the Amahi API as well as auto mount as NFS or SMB shares to allow the usage of applications through locally mounted shares (such as gallery, subsonic etc)[https://github. This would allow you to connect Windows com/amahi/amahi-anywhere-fs/ Linux computers as data nodes. Perhaps an installable agent?Amahi Anywhere FS Github repo]

'''Objective''': An installer that integrates with Amahi (a stripped down version of Amahi?) and a management pane ===Improvements in the main amahi server that allows you to add a server by IP or DNS name.External Proxy===

'''Skills RequiredDescription''': Ruby, misc system scripting, gitExternal proxy provides API endpoints for users to remotely access Amahi Anywhere File Server

'''MentorsObjective''': Carlos, Dan, RodFollowing features can be implemented:

'''ObjectiveSkills Required''': Being able to upgrade Amahi versions without having to upgrade OSs is very appealing and a huge win.GoLang

'''Skills RequiredMentors''': major Linux packaging mojoCarlos, ruby, system scripting, ISO packaging, repo creation, gitChirag

== GUI * Add features to our popular mobile apps: Offer to display image-heavy folders and shares within a "gallery" or collection view, add the ability to navigate and stream shares containing music in a streamlined way, Dynamic search, SPDY support, for both remote and local queries, support for accessing HDA web applications within Amahi for iOS, share folders and files from your HDA to other apps or users, support for HDA user permissions (share & web app restrictions, etc.). Mentors available: Carlos* PHP API: make a native PHP SDK for the Amahi platform, so that PHP apps (we have a lot of them) can more easy be integrated * Integrate a mail server as an app. Identify any settings or configuration that need to be implemented in the platform* Router integration, UPNP, direct control* Port AES (Amahi Energy Server) to the latest Amahi* Integration of LDAP as a back-end management system, calendaring* Feature development (examples):* Calendaring, and integrated contact manager application. Possible options: 1) ownCloud based or 2) Apache carddav* For the more design-oriented, build mobile theme(s)* Documentation or screencasts/tutorials* Use sandboxing and containers to improve app stability, updating and more* Improve installation and user onboarding (OOBE)* Better upgrades with backup of apps, settings, etc.* Create a backup and restore function for the Amahi Server (Idea is to backup the of the setting like the shares, paths and Fixed IP address and Mac Address, remove all the data drives) reinstall the OS or Upgrade and then put the data dives back in and then restore all the setting)* make the Amahi front end webpage more mobile-friendly* Add Icon for the install app pages and have more screenshots* make it easier to run multi servers on one network* DHCP page a button to add a device to Fixed IP address will be able to change the fix IP address and the Name or just us the default one* update Button on installed apps this will only work on apps that are updateable, it will run an update script from when the was created, lots of apps nowadays are updated able and would save time uninstalled and reinstalling* Create a page or tab on Amahi front end to be able to add docker container apps select icon and name and address:port   Plus, of course we are open to suggestions. Open a dialog. We're happy to discuss and UX determine a suitable project. Amahi is a platform that will support the deployment of other open source applications. If you are interested in the integration of applications in your area of interest, just contact us with suggestions. =Mentors=

This area can offer is a list of '''a lotcommitted''' of possibilities for ideasmentors. A lot can be improved If you are interested in Amahi to make the users happier. We are listing one topic here, but there are manymentoring, from a better front-end HTML let us know via IRC (responsiveness, html5 compliance, browser compatibility, etc.mention the nicks below), to CSS re-implementation, to allow for nice JS libraries to be used in plugins easily, like D3.js, Highcharts, etc., etc.:

'''Objective'''Reference:* allow the usage of popular themes out there, like themes for Drupal, Wordpress, etc[https://google.github.io/gsocguides/mentor/ GSoC mentoring page]., with minor configuration changes, or even directly* allow the integration of mobile themes* provide hooks to detect mobile devices and present a mobile theme

'''Skills Required''': CSSAmahi participated in GSOC in 2020, HTML52019, ruby2018, RoR[[Google Summer of Code 2017]] 2016, gitand [[Google Summer of Code 2014]]

* Integrate a mail server* Router integration, UPNP, direct control* Port AES (Amahi Energy Server) to Amahi 7* Integration '''Objective''': Addition of LDAP as a back-end management system, calendaring* Feature development (examples):* Calendaring, new features and integrated contact manager application: possible workimprovements in pre-around - owncloud* For the more design-oriented, build mobile theme(s)* PHP API: make it easy existing ones in iOS app in swift to customize at least match or surpass the many apps that use phpAndroid app

Amahi is a platform that will support the deployment of other open source applications. If you are interested in the integration of applications in your area of interest'''Skills Required''': iOS programming, just contact us with suggestions.Swift

='''Mentors=Reference [http'''://en.flossmanuals.net/GSoCMentoring/ GSOC mentoring page]. This is a list of committed mentors. If you are interested in mentoringCarlos, let us knowChirag

* Carlos Puchol (cpg, PST, GSOC admin)'''Reference''': team lead for Amahi, experience in RoR, Go, Ruby, RoR, system scripting[https://github.com/amahi/development, app packaging, C, C++* Bogdan Mitrea (megabitdragon, CST, GSOC admin): Android, Java, app packaging, system programming, community lead* Rod Runyon (bigfoot65, CST): app lead for ios Amahi, system programming, app packaging, reliability, documentation, support* Jesse Read (DarthNerdus, EST): mobile team lead, system development, Objective C, iOS, Java, Android, C, C++, and much more* Daniel Falk (dnfalk, CST): system development and management, virtualization, networking, infrastructure* Dag Notland (dano5, CET): app packaging, system programming, community leadrepo]