Skip to content

Liv é uma aplicação web que tem como objetivo trazer modelos de leitura não-convencionais para crianças e jovens de todo o Brasil, tendo em vista que os modelos atuais estão cada vez mais distantes do que eles têm lido atualmente. Projeto desenvolvido na terceira edição do Mega Hack.

Notifications You must be signed in to change notification settings

LissandraRodrigues/projeto_liv_mega_hack

Repository files navigation

Liv - Mega Hack 3.0

Meu time e eu escolhemos o desafio da Árvore Educação inserido no Mega Hack .

Nossa solução consiste em uma aplicação web que permite o usuário ler ou ouvir livros pelo aplicativo Whatsapp.

  • Página inicial.

alt text

  • Página do Livro Dom Casmurro de Machado de Assis.

alt text

Descrição

  • Site

No site do Liv, o usuário escolhe o livro que deseja ler, digita o número do celular, a quantidade de capítulos que quer receber por dia, o horário que quer recebê-los e o formato de leitura desejado.

  • Leitura no WhatsApp

O programa faz a leitura de um arquivo txt que contém o livro Dom Casmurro de Machado de Assis (escolhemos este livro para a demonstração). Após a leitura, o programa separa o livro em capítulos e envia esses capítulos pelo WhatsApp no formato de mensagem de texto. Cada uma das mensagens enviadas é um parágrafo do capítulo.

Obs.: O livro utilizado foi encontrado no formato de pdf nesta página do Ministério da Educação e foi convertido para a extensão txt utilizando esta ferramenta online.

  • Audiobook no Whatsapp

O programa acessa o Whatsapp, entra em um grupo específico do livro escolhido e encaminha, ao usuário que solicitou, o áudio.

Obs. 1: O grupo referido acima é feito dentro do aplicativo Whatsapp antes da execução do programa e contém o áudio do livro.

Obs. 2: O áudio utilizado pode ser encontrado nesta página .

Obs. 3: A parte da solução responsável por converter os livros em mensagens de texto e áudios no Whatsapp foi escrita na linguagem Python e usa a biblioteca Selenium como base.

Como funciona?

O usuário entra no site, escolhe o livro que quer ler, opta por áudio ou mensagem de texto, cadastra o número de celular e recebe o livro no formato escolhido em seu celular. Para mais detalhes acesse esse vídeo de demonstração.

Instalação

É preciso ter o Python instalado no seu computador (Python , recomendado baixar a última versão). Para importar algumas funções usadas nesse projeto é preciso fazer a instalação de uma biblioteca:

  • selenium - Forma de instalação: pip install selenium

Obs 01.: É também necessário o uso do ChromeDriver 83.0.4103.39 que pode ser baixado nesta página . Ele deve ser inserido na mesma pasta do projeto, entretanto ele já está inserido neste repositório.

Uso

Após as instalações, para começar usar é preciso clonar esse repositório e seguir alguns parâmetros que serão passados pela linha de comando (terminal):

  • Para receber o livro como mensagem de texto:

    • python enviaMensagemTexto.py -c <Número do Capítulo> -n <Nome do usuário que você enviará o livro (tem que ser exatamente igual ao que está no WhatsApp)>

      Exemplo: python enviaMensagemTexto.py -c 19 -n João

      Obs.: Para demonstração, utilizamos o livro Dom Casmurro, que possui 148 capítulos, por isso, escolha um capítulo inserido no intervalo de 1 a 148.

  • Para receber o livro como audiobook:

    • Para o programa funcionar é necessário que previamente um grupo no Whatsapp seja criado com exatamente o nome "Dom Casmurro - Machado A." e neste grupo deve ser colocado o MP3 que pode ser encontrado aqui.

    • python enviaAudio.py -n <Nome do usuário que você enviará o livro (tem que ser exatamente igual ao que está no WhatsApp)>

      Exemplo: python enviaMensagemTexto.py -n João

Time

About

Liv é uma aplicação web que tem como objetivo trazer modelos de leitura não-convencionais para crianças e jovens de todo o Brasil, tendo em vista que os modelos atuais estão cada vez mais distantes do que eles têm lido atualmente. Projeto desenvolvido na terceira edição do Mega Hack.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published